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:o tamanho máximo da mensagem de e-mail é de 25 MB. Esse limite inclui os cabeçalhos de metadados, o corpo e os anexos da mensagem.
  • Tipos de mídia MIME aceitos: message/rfc822

O limite de projeto para a API Migration de grupos é de 10 consultas por segundo (QPS) por conta. O máximo de solicitações de API por dia é 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 dele 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 modo 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 este 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 acompanhada pelo 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 tentar novamente a chamada com falha.

INVALID MESSAGE FAILURE: a mensagem de e-mail está em um formato inválido. Se uma mensagem for rejeitada como inválida, você vai receber um código de status HTTP 400 Bad Request. Confira alguns exemplos de formato inválido:

  • A mensagem pode ter campos From, To e Date ausentes.
  • Um erro ocorre se uma linha na mensagem não for encerrada por uma quebra de linha no 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 dos Grupos para empresas do Google.

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

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