Archive: insert

Migra un mensaje de correo electrónico al archivo del Grupo de Google mediante la carga de contenido multimedia.

Este método admite un URI /upload y acepta contenido multimedia subido con las siguientes características:

  • Tamaño máximo del archivo: El tamaño máximo del mensaje de correo electrónico es de 25 MB. Este límite incluye los encabezados, el cuerpo y los archivos adjuntos de los metadatos del mensaje.
  • Tipos de MIME multimedia aceptados: message/rfc822

El límite de proyectos para la API de migración de Grupos es de 10 consultas por segundo (QPS) por cuenta. La cantidad máxima de solicitudes a la API por día es de 500,000. Para obtener más información sobre el formato RFC822, consulta el formato estándar RFC822.

Solicitud

Solicitud HTTP

POST https://www.googleapis.com/upload/groups/v1/groups/groupId/archive?uploadType=media

Parámetros

Nombre del parámetro Valor Descripción
Parámetros de ruta de acceso
groupId string La dirección de correo electrónico del grupo en el que se archiva el correo electrónico migrado. Esta dirección de correo electrónico es una variable en la ruta de URL de la solicitud. Si el propietario de un grupo cambia la dirección de correo electrónico del grupo mediante la Consola del administrador o la API de Directory, debes usar la nueva dirección de correo electrónico en la variable groupId.
Parámetros de consulta obligatorios
uploadType string

Es el tipo de solicitud de carga para el URI /upload con uno de los siguientes valores:

  • media: Una carga simple que sube los datos multimedia
  • resumable: Es una carga reanudable que sube el archivo de manera reanudable, con una serie de al menos dos solicitudes.

Autorización

Esta solicitud requiere una autorización con el siguiente alcance:

Permiso
https://www.googleapis.com/auth/apps.groups.migration

Para obtener más información, consulta la página de autenticación y autorización.

Cuerpo de la solicitud

No proporciones un cuerpo de solicitud con este método.

Respuesta

Si se aplica correctamente, este método muestra un cuerpo de respuesta con la siguiente estructura:

{
  "kind": "groupsmigration#groups",
  "responseCode": string
}
Nombre de la propiedad Valor Descripción
kind string Este es el tipo de recurso de inserción. Valor: groupsmigration#groups
responseCode string

El código de estado de una respuesta a la API para una solicitud de migración junto con el código de estado HTTP. Los valores de estado responseCode incluyen lo siguiente:

AUTHORIZATION FAILURE: Las credenciales de autorización del administrador no son válidas. Se muestra un código de estado HTTP 401.

BACKEND FAILURE: El servidor tiene un problema o está ocupado. Se muestra un código de estado HTTP 503. Con un algoritmo de retirada exponencial, espera una pequeña demora antes de reintentar la llamada con errores.

INVALID MESSAGE FAILURE: El mensaje de correo electrónico tiene un formato no válido. Si se rechaza un mensaje por formato incorrecto, recibirás un código de estado HTTP 400 Bad Request. Estos son algunos ejemplos de formatos no válidos:

  • Es posible que al mensaje le falten los campos From, To y Date.
  • Se produce un error si una línea en el mensaje no finaliza con una línea nueva de estilo CR+LF (es decir, "\r\n").
  • El mensaje de correo electrónico está vacío.
  • El grupo de destino de la migración no existe o está en modo de “solo lectura”. Para obtener más información sobre el modo de uso compartido de solo lectura, consulta las opciones de uso compartido de Google Groups for Business.

SUCCESS: El correo se archivó correctamente en el archivo del grupo de la cuenta. Se muestra un código de estado HTTP 200.

UNSUPPORTED_PARALLEL_OPERATION: La API de Groups Migration no admite inserciones de mensajes paralelos en el mismo archivo de grupo. Además, la API de migración de grupos no admite solicitudes por lotes. Sin embargo, la API de Groups Migration admite solicitudes paralelas de inserciones de correo electrónico en diferentes archivos de grupo. Se muestra un código de estado HTTP 400.