Archive: insert

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

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

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

La limite de projet pour l'API Migration de groupes est de 10 requêtes par seconde (RPS) par compte. Le nombre maximal de requêtes API par jour est de 500 000. Pour en savoir plus 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 l'e-mail migré est archivé. Cette adresse e-mail est une variable dans le chemin d'accès de l'URL de la requête. Si un propriétaire modifie l'adresse e-mail du groupe dans la console d'administration ou l'API Directory, vous devez utiliser la nouvelle adresse e-mail dans la variable groupId.
Paramètres de requête obligatoires
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 de manière récapitulative, à l'aide d'une série d'au moins deux requêtes.

Autorisation

Cette requête nécessite une autorisation ayant la portée suivante:

Portée
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. Valeur: groupsmigration#groups
responseCode string

Code d'état de la réponse d'une API pour une requête de migration, accompagné du code d'état HTTP. Les valeurs d'état responseCode sont les suivantes:

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 relancer l'appel ayant échoué.

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

  • Il manque peut-être les champs From, To et Date 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 courrier 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'est pas compatible avec les insertions de messages parallèles dans la même archive de groupe. De plus, l'API Groups Migration n'est pas compatible avec les requêtes par lot. Toutefois, l'API Groups Migration accepte les requêtes parallèles d'insertion d'e-mails dans différentes archives de groupes. Un code d'état HTTP 400 est renvoyé.