Esta página foi traduzida pela API Cloud Translation.

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

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.

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.