Cette page a été traduite par l'API Cloud Translation.

Archive: insert

Transfère un e-mail dans l'archive du groupe Google à l'aide de l'importation de contenu multimédia.

Cette méthode accepte un URI /upload et accepte les contenus multimédias importés présentant les caractéristiques suivantes:

Taille maximale des fichiers:la taille maximale des messages envoyés aux e-mails est de 25 Mo. Cette limite inclut les en-têtes de métadonnées, le corps et les éventuelles pièces jointes du message.
Types MIME de médias acceptés:message/rfc822

La limite de projet pour l'API Groups Migration est de 10 requêtes par seconde (RPS) et par compte. Le nombre maximal de requêtes API par jour est de 500 000. Pour plus d'informations sur le format RFC822, consultez le format standard RFC822.

Requête

Requête HTTP

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

Paramètres

Nom du paramètre	Valeur	Description
Paramètres de chemin d'accès
`groupId`	`string`	Adresse e-mail du groupe dans lequel les e-mails migrés sont archivés. Cette adresse e-mail est une variable du chemin d'URL de la requête. Si le propriétaire d'un groupe modifie l'adresse e-mail du groupe à l'aide de la console d'administration ou de l'API Directory, vous devez utiliser la nouvelle adresse e-mail dans la variable `groupId`.
Paramètres de requête requis
`uploadType`	`string`	Type de requête d'importation vers l'URI `/upload` avec l'une des valeurs suivantes: `media` : importation simple qui importe les données multimédias. `resumable` : importation avec reprise qui importe le fichier avec reprise à l'aide d'une série d'au moins deux requêtes.

Autorisation

Cette requête nécessite une autorisation ayant le champ d'application suivant:

Définition du champ d'application
`https://www.googleapis.com/auth/apps.groups.migration`

Pour en savoir plus, consultez la page Authentification et autorisation.

Corps de la requête

Ne fournissez pas de corps de requête avec cette méthode.

Réponse

Si la requête aboutit, cette méthode renvoie un corps de réponse présentant la structure suivante :

{
  "kind": "groupsmigration#groups",
  "responseCode": string
}

Nom de propriété Valeur Description

kind string Type de ressource d'insertion dont il s'agit. Valeur: groupsmigration#groups

Nom de propriété	Valeur	Description
`kind`	`string`	Type de ressource d'insertion dont il s'agit. Valeur: `groupsmigration#groups`
`responseCode`	`string`	Code d'état d'une réponse d'API pour une requête de migration, accompagné du code d'état HTTP. Les valeurs d'état `responseCode` incluent les éléments suivants: `AUTHORIZATION FAILURE` : les identifiants d'autorisation de l'administrateur ne sont pas valides. Un code d'état HTTP `401` est renvoyé. `BACKEND FAILURE` : le serveur rencontre un problème ou est occupé. Un code d'état HTTP `503` est renvoyé. À l'aide d'un algorithme d'intervalle exponentiel entre les tentatives, attendez un court délai avant de réessayer l'appel ayant échoué. `INVALID MESSAGE FAILURE` : le format de l'e-mail n'est pas valide. Si un message est rejeté pour cause de format incorrect, vous recevez un code d'état HTTP `400 Bad Request`. Voici quelques exemples de formats non valides: Il est possible que les champs `From`, `To` et `Date` soient manquants dans le message. Une erreur se produit si une ligne du message n'est pas terminée par un saut de ligne de style CR+LF (c'est-à-dire `"\r\n"`). L'e-mail est vide. Le groupe cible de la migration n'existe pas ou est en mode lecture seule. Pour en savoir plus sur le mode de partage en lecture seule, consultez les options de partage de Google Groups for Business. `SUCCESS` : le message a bien été archivé dans l'archive de groupe du compte. Un code d'état HTTP `200` est renvoyé. `UNSUPPORTED_PARALLEL_OPERATION` : l'API Groups Migration n'accepte pas l'insertion de messages en parallèle dans la même archive de groupe. De plus, l'API Groups Migration n'est pas compatible avec les requêtes par lot. Cependant, l'API Groups Migration accepte les requêtes parallèles d'insertion d'e-mails dans différentes archives de groupe. Un code d'état HTTP `400` est renvoyé.

responseCode

string

Code d'état d'une réponse d'API pour une requête de migration, accompagné du code d'état HTTP. Les valeurs d'état responseCode incluent les éléments suivants:

AUTHORIZATION FAILURE : les identifiants d'autorisation de l'administrateur ne sont pas valides. Un code d'état HTTP 401 est renvoyé.

BACKEND FAILURE : le serveur rencontre un problème ou est occupé. Un code d'état HTTP 503 est renvoyé. À l'aide d'un algorithme d'intervalle exponentiel entre les tentatives, attendez un court délai avant de réessayer l'appel ayant échoué.

INVALID MESSAGE FAILURE : le format de l'e-mail n'est pas valide. Si un message est rejeté pour cause de format incorrect, vous recevez un code d'état HTTP 400 Bad Request. Voici quelques exemples de formats non valides:

Il est possible que les champs From, To et Date soient manquants dans le message.
Une erreur se produit si une ligne du message n'est pas terminée par un saut de ligne de style CR+LF (c'est-à-dire "\r\n").
L'e-mail est vide.
Le groupe cible de la migration n'existe pas ou est en mode lecture seule. Pour en savoir plus sur le mode de partage en lecture seule, consultez les options de partage de Google Groups for Business.

SUCCESS : le message a bien été archivé dans l'archive de groupe du compte. Un code d'état HTTP 200 est renvoyé.

UNSUPPORTED_PARALLEL_OPERATION : l'API Groups Migration n'accepte pas l'insertion de messages en parallèle dans la même archive de groupe. De plus, l'API Groups Migration n'est pas compatible avec les requêtes par lot. Cependant, l'API Groups Migration accepte les requêtes parallèles d'insertion d'e-mails dans différentes archives de groupe. Un code d'état HTTP 400 est renvoyé.