Todos os produtos
Search
Central de documentação

Drive and Photo Service:Batch

Última atualização: Jul 04, 2026

Combina múltiplas chamadas de API em uma única solicitação para melhorar a eficiência.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Sintaxe da solicitação

POST /v2/batch HTTP/1.1

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

domain_id

string

Sim

body

object

Não

Contém os parâmetros do corpo da solicitação.

resource

string

Sim

O tipo de recurso das sub-solicitações. Os tipos de recurso suportados incluem:

  • file: Um arquivo.

  • drive: Um drive.

  • user: Um usuário.

  • group: Um grupo.

  • membership: Uma associação de grupo.

  • share_link: Um link de compartilhamento.

  • async_task: Uma tarefa assíncrona.

Valores válidos:

  • share_link :

    link de compartilhamento.

  • file :

    arquivo.

  • async_task :

    tarefa assíncrona.

  • membership :

    associação de grupo.

  • drive :

    drive.

  • user :

    usuário.

  • group :

    grupo.

file

requests

array<object>

Sim

Uma coleção de sub-solicitações.

Uma solicitação em lote pode conter de 1 a 100 sub-solicitações.

array<object>

Não

Um objeto de sub-solicitação.

id

string

Sim

O ID exclusivo da sub-solicitação. Este ID é usado para correlacionar a sub-solicitação com sua resposta. Os IDs devem ser exclusivos dentro de uma solicitação em lote.

93433894994ad2e1

method

string

Sim

O método HTTP da sub-solicitação. Os métodos suportados incluem:

  • POST

  • GET

  • PUT

  • DELETE

  • HEAD

Valores válidos:

  • HEAD :

    HEAD.

  • DELETE :

    DELETE.

  • POST :

    POST.

  • GET :

    GET.

  • PUT :

    PUT.

POST

url

string

Sim

O caminho da API da sub-solicitação. Os caminhos suportados incluem:

  • /file/get: Obter detalhes do arquivo.

  • /file/update: Atualizar informações do arquivo.

  • /file/search: Pesquisar arquivos.

  • /file/copy: Copiar um arquivo ou pasta.

  • /file/move: Mover um arquivo ou pasta.

  • /file/delete: Excluir um arquivo ou pasta.

  • /file/get_download_url: Obter a URL de download de um arquivo.

  • /file/get_share_link_download_url: Obter a URL de download de um link de compartilhamento.

  • /recyclebin/trash: Mover um arquivo ou pasta para a lixeira.

  • /recyclebin/restore: Restaurar um arquivo ou pasta da lixeira.

  • /file/put_usertags: Definir tags de usuário.

  • /file/delete_usertags: Excluir tags de usuário.

  • /drive/get: Obter informações do drive.

  • /user/get: Obter informações do usuário.

  • /group/get: Obter informações do grupo.

  • /share_link/create: Criar um link de compartilhamento.

  • /share_link/update: Atualizar um link de compartilhamento.

  • /share_link/cancel: Cancelar um link de compartilhamento.

  • /share_link/list: Listar links de compartilhamento.

  • /share_link/get: Obter informações do link de compartilhamento.

  • /share_link/get_share_token: Obter um token de compartilhamento.

  • /async_task/get: Obter informações da tarefa assíncrona.

Valores válidos:

  • /file/copy :

    Copy file or folder

  • /file/get_share_link_download_url :

    Get share link download URL

  • /file/move :

    Move file or folder

  • /share_link/create :

    Create share link

  • /share_link/update :

    Update share link

  • /async_task/get :

    Get asynchronous task information

  • /drive/get :

    Get drive information

  • /group/get :

    Get group information

  • /share_link/list :

    List share links

  • /file/delete :

    Delete file or folder

  • /share_link/get :

    Get share link information

  • /file/get :

    Get file details

  • /file/get_download_url :

    Get file download URL

  • /recyclebin/restore :

    Restore file or folder

  • /file/update :

    Update file information

  • /recyclebin/trash :

    Move to recycle bin

  • /file/search :

    Search files

  • /user/get :

    Get user information

  • /share_link/get_share_token :

    Get share token

  • /share_link/cancel :

    Cancel share link

/file/get

body

object

Não

O corpo da solicitação da sub-solicitação. Para mais detalhes, consulte a documentação da operação de API específica.

Se você especificar o parâmetro body, também deverá definir o cabeçalho de solicitação Content-Type como application/json.

any

Não

O corpo da solicitação da sub-solicitação.

{"domain_id":"1","drive_id":"1"}

headers

object

Não

Os cabeçalhos de solicitação da sub-solicitação.

string

Não

Os cabeçalhos de solicitação da sub-solicitação.

{"Content-Type":"application/json"}

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os parâmetros de resposta.

responses

array<object>

Uma coleção de respostas às sub-solicitações.

array<object>

Um objeto de resposta para uma única sub-solicitação.

id

string

O ID da sub-solicitação à qual esta resposta corresponde.

93433894994ad2e1

status

integer

O código de status HTTP da sub-solicitação. Para mais detalhes, consulte a documentação da operação de API específica.

200

body

object

O corpo da resposta da sub-solicitação. Para mais detalhes, consulte a documentação da operação de API específica.

any

O corpo da resposta da sub-solicitação.

{"domain_id":"1","drive_id":"1","file_id":"9520943DC264"}

Exemplos

Resposta de sucesso

JSON formato

{
  "responses": [
    {
      "id": "93433894994ad2e1",
      "status": 200,
      "body": {
        "key": "{\"domain_id\":\"1\",\"drive_id\":\"1\",\"file_id\":\"9520943DC264\"}"
      }
    }
  ]
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.