Antes de migrar um e-mail para os Grupos do Google usando a API Groups Migration, faça o seguinte
- Confirme se o grupo de destino existe e se o e-mail do grupo está correto antes de migrar uma mensagem para o arquivo dele. Para mais informações sobre grupos de fichas e usuários, consulte a API Directory.
- Se o remetente do e-mail tiver o mesmo domínio que o grupo de destino, confirme se o remetente existe antes de migrar a mensagem para o arquivo do grupo de destino.
- O formato da mensagem de e-mail precisa estar na definição padrão do RFC 822.
Use o cabeçalho
Content-type: message/rfc822
. Confirme se os camposTo:
,From:
eDate:
da mensagem de e-mail estão formatados corretamente. A resposta é retornada no formato de dados JSON.
Migrar uma mensagem de e-mail para o Grupos do Google
Para migrar uma mensagem de e-mail para o arquivo de um grupo, envie uma solicitação HTTP POST
,
inclua o cabeçalho Authorization
e substitua
GROUP_EMAIL_ADDRESS
pelo endereço de e-mail do grupo a que as mensagens
se referem:
POST https://www.googleapis.com/upload/groups/v1/groups/GROUP_EMAIL_ADDRESS/archive?uploadType=media
Exemplo de solicitação
Este exemplo migra mensagens de e-mail para o arquivo samplegroup@googlegroups.com. O
Content-Length
está limitado a 25 MB, o que inclui os metadados, o corpo e os
anexos da mensagem:
POST https://www.googleapis.com/upload/groups/v1/groups/samplegroup@googlegroups.com/archive?uploadType=media
Host: www.googleapis.com
Content-Type: message/rfc822
Content-Length: BYTES
Authorization: Bearer Auth token
METADATA_BODY
Substitua:
BYTES
: o número de bytes no e-mail.AUTH_TOKEN
: o cabeçalho Authorization
.METADATA_BODY
: os metadados, o corpo e os anexos do e-mail.Confira a seguir um exemplo de mensagem de e-mail no formato de texto RFC 822 que foi migrada para o
arquivo de samplegroup@googlegroups.com. O NNNN@mail.samplegroup.com
é
o Message-ID deste exemplo. O remetente do e-mail migrado é sampleender@example.com, e o e-mail é
migrado para o arquivo do grupo samplegroup@googlegroups.com:
Received: by 10.143.160.15 with HTTP; Mon, 16 Jul 2007 10:12:26 -0700 (PDT) Message-ID: <NNNN@mail.samplegroup.com> Date: Mon, 16 Jul 2007 10:12:26 -0700 From: samplesender@example.com To: samplegroup@googlegroups.com Subject: SUBJECT MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Content-Disposition: inline Delivered-To: samplegroup@samplegroup.com This is the body of the migrated email message.
Uma resposta bem-sucedida retornará um código de status HTTP 200
e o status da migração.
Saiba mais sobre os valores responseCode
em a referência da API Groups Migration.
{ "kind": "groupsMigration#groups", "responseCode": "SUCCESS", }
Visualizar mensagens importadas na interface do Grupos do Google
No Grupos do Google, o estado de leitura/não lida das conversas é armazenado separadamente para cada usuário. Ao inserir mensagens e conversas usando a API Groups Migration, elas são tratadas como se tivessem sido enviadas pelo usuário no cabeçalho From:
. Isso significa que elas aparecem como não lidas
para todos os usuários, exceto para o usuário com o endereço no cabeçalho From:
. Por exemplo,
após o exemplo de solicitação JSON anterior, a mensagem intitulada SUBJECT
aparecerá como lida
se samplesender@example.com
tiver feito login no Grupos do Google, mas aparecerá como não lida
para todos os outros usuários.