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 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

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.

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.