Archive: insert

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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 de /upload e aceita mídias enviadas com as seguintes características:

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

O limite de projeto da 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 é 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 faz upload dos 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 de 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 de 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 está com um problema ou está ocupado. Um código de status HTTP 503 é retornado. Usando um algoritmo de espera exponencial (em inglês), 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 malformada, você receberá um código de status HTTP 400 Bad Request. Veja 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 é encerrada por uma nova 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 do Grupos do Google para empresas.

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

UNSUPPORTED_PARALLEL_OPERATION: a API Groups Migration não é compatível com inserções de mensagens paralelas 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ção de e-mails em diferentes arquivos de grupo. Um código de status HTTP 400 é retornado.