Se usó la API de Cloud Translation para traducir esta página.

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 de los archivos: El tamaño máximo de los mensajes de correo electrónico es de 25 MB. Este límite incluye los encabezados de metadatos, el cuerpo y los archivos adjuntos del mensaje.
Tipos de MIME de contenido multimedia aceptados: message/rfc822

El límite de proyectos de la API de Groups Migration 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`	Es 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 con la Consola del administrador o la API de Directory, debes usar la dirección de correo electrónico nueva en la variable `groupId`.
Parámetros de consulta obligatorios
`uploadType`	`string`	Es el tipo de solicitud de carga al URI `/upload` con uno de los siguientes valores: `media`: Carga simple que sube los datos del contenido multimedia. `resumable`: Carga reanudable que sube el archivo de forma reanudable con una serie de al menos dos solicitudes.

Autorización

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

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

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 de la API para una solicitud de migración acompañado del 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 un pequeño retraso antes de reintentar la llamada fallida. `INVALID MESSAGE FAILURE`: El mensaje de correo electrónico tiene un formato no válido. Si se rechaza un mensaje porque tiene un formato incorrecto, recibirás un código de estado HTTP `400 Bad Request`. Estos son algunos ejemplos de formato no válido: Es posible que falten los campos `From`, `To` y `Date` en el mensaje. Se produce un error si una línea del mensaje no termina con un salto de línea 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 Grupos de Google para empresas. `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 en paralelo en el mismo archivo de grupo. Además, la API de Groups Migration no admite solicitudes por lotes. Sin embargo, la API de Groups Migration admite solicitudes en paralelo para inserciones de correo electrónico en diferentes archivos de grupos. Se muestra un código de estado HTTP `400`.

responseCode

string

El código de estado de una respuesta de la API para una solicitud de migración acompañado del 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 un pequeño retraso antes de reintentar la llamada fallida.

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

Es posible que falten los campos From, To y Date en el mensaje.
Se produce un error si una línea del mensaje no termina con un salto de línea 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 Grupos de Google para empresas.

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 en paralelo en el mismo archivo de grupo. Además, la API de Groups Migration no admite solicitudes por lotes. Sin embargo, la API de Groups Migration admite solicitudes en paralelo para inserciones de correo electrónico en diferentes archivos de grupos. Se muestra un código de estado HTTP 400.