Archive: insert

Migra uma mensagem de e-mail para o arquivo do Grupo do Google usando o upload de mídia.

Esse método é compatível com um URI /upload e aceita mídias enviadas com as seguintes características:

  • Tamanho máximo do arquivo: a mensagem de e-mail pode ter até 25 MB. Esse limite inclui os cabeçalhos, o corpo e os anexos dos metadados da mensagem.
  • Tipos MIME de mídia aceitos: message/rfc822

O limite do projeto para a API Groups Migration é de 10 consultas por segundo (QPS) por conta. O número máximo de solicitações de API por dia é de 500.000. Para mais informações sobre o formato RFC822, consulte o formato padrão RFC822.

Solicitação

Solicitação HTTP

POST https://www.googleapis.com/upload/groups/v1/groups/groupId/archive?uploadType=media

Parâmetros

Nome do parâmetro Valor Descrição
Parâmetros de caminho
groupId string O endereço de e-mail do grupo em que o e-mail migrado está arquivado. Esse endereço de e-mail é uma variável no caminho do URL da solicitação. Se o proprietário de um grupo alterar o endereço de e-mail do grupo usando o Admin Console ou a API Directory, você precisará usar o novo endereço de e-mail na variável groupId.
Parâmetros de consulta obrigatórios
uploadType string

É o tipo de solicitação de upload para o URI /upload com um dos seguintes valores:

  • media: upload simples que envia os dados de mídia.
  • resumable: upload retomável que faz upload do arquivo de maneira retomável usando uma série de pelo menos duas solicitações.

Autorização

Esta solicitação requer autorização com o seguinte escopo:

Escopo
https://www.googleapis.com/auth/apps.groups.migration

Para mais informações, consulte a página autenticação e autorização.

Corpo da solicitação

Não forneça um corpo de solicitação com esse método.

Resposta

Se for bem-sucedido, esse método retornará um corpo de resposta com esta estrutura:

{
  "kind": "groupsmigration#groups",
  "responseCode": string
}
Nome da propriedade Valor Descrição
kind string O tipo de recurso de inserção. Valor: groupsmigration#groups
responseCode string

O código de status de uma resposta da API para uma solicitação de migração, acompanhado do código de status HTTP. Os valores de status responseCode incluem o seguinte:

AUTHORIZATION FAILURE: as credenciais de autorização do administrador são inválidas. Um código de status HTTP 401 é retornado.

BACKEND FAILURE: o servidor tem um problema ou está ocupado. Um código de status HTTP 503 é retornado. Usando um algoritmo de espera exponencial, aguarde um pequeno atraso antes de repetir a chamada com falha.

INVALID MESSAGE FAILURE: a mensagem de e-mail tem um formato inválido. Se uma mensagem for rejeitada como malformada, você receberá um código de status HTTP 400 Bad Request. Entre os exemplos de formato inválido estão:

  • A mensagem pode não ter os campos From, To e Date.
  • Um erro vai ocorrer se uma linha na mensagem não for encerrada por uma nova linha de estilo CR+LF (ou seja, "\r\n").
  • A mensagem de e-mail está vazia.
  • O grupo de destino da migração não existe ou está no modo "somente leitura". Para mais informações sobre o modo de compartilhamento somente leitura, consulte as opções de compartilhamento do Grupos do Google para empresas.

SUCCESS: o e-mail foi arquivado com sucesso no arquivo do grupo da conta. Um código de status HTTP 200 é retornado.

UNSUPPORTED_PARALLEL_OPERATION: a API Groups Migration não é compatível com inserções paralelas de mensagens no mesmo arquivo de grupo. Além disso, a API Groups Migration não é compatível com solicitações em lote. No entanto, a API Groups Migration é compatível com solicitações paralelas de inserções de e-mails em arquivos de grupos diferentes. Um código de status HTTP 400 é retornado.