Migrar e-mails

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