Migrar e-mails

Antes de migrar um e-mail para o 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 de e-mail para o arquivo desse grupo. Para mais informações sobre como listar grupos e usuários, consulte a API Directory.
  • Se o remetente do e-mail tiver o mesmo domínio do grupo de destino, confirme se o remetente do e-mail existe antes de migrar a mensagem de e-mail para o arquivo do grupo de destino.
  • O formato da mensagem de e-mail precisa estar na definição padrão RFC 822. Use o cabeçalho Content-type: message/rfc822. Confirme se os campos To:, From: e Date: 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 para o qual as mensagens são destinadas:

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 é limitado a 25 MB, o que inclui os metadados, o corpo e todos 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 todos os anexos do e-mail.

Confira abaixo 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 ID da mensagem deste exemplo. O remetente do e-mail migrado é samplesender@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 retorna um código de status HTTP 200 e o status da migração. Para mais informações sobre os valores de responseCode, consulte a referência da API Groups Migration.

{
 "kind": "groupsMigration#groups",
 "responseCode": "SUCCESS",
}

Ver mensagens importadas na interface do Grupos do Google

No Grupos do Google, o estado lido ou não lido 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 aquele cujo endereço está no cabeçalho From:. Por exemplo, após o exemplo de solicitação JSON anterior, a mensagem intitulada SUBJECT aparece como lida se samplesender@example.com tiver feito login no Grupos do Google, mas aparece como não lida para todos os outros usuários.