Archive: insert

Medya yüklemeyi kullanarak bir e-posta iletisini Google grubunun arşivine taşır.

Bu yöntem bir /upload URI'sini destekler ve aşağıdaki özelliklere sahip medyayı kabul eder:

  • Maksimum dosya boyutu: Maksimum posta iletisi boyutu 25 MB'tır. Bu sınıra iletinin meta veri üstbilgileri, gövdesi ve ekleri dahildir.
  • Kabul edilen Medya MIME türleri: message/rfc822

Groups Migration API için proje sınırı, hesap başına saniyede 10 sorgudur (QPS). Günlük maksimum API isteği sayısı 500.000'dir. RFC822 biçimi hakkında daha fazla bilgi için RFC822 standart biçimine bakın.

İstek

HTTP isteği

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

Parametreler

Parametre adı Değer Açıklama
Yol parametreleri
groupId string Taşınan e-postanın arşivlendiği grubun e-posta adresi. Bu e-posta adresi, isteğin URL yolundaki bir değişkendir. Bir grup sahibi, grubun e-posta adresini Yönetici Konsolu'nu veya Directory API'yi kullanarak değiştirirse groupId değişkeninde yeni e-posta adresini kullanmanız gerekir.
Gerekli sorgu parametreleri
uploadType string

Aşağıdaki değerlerden biriyle /upload URI'sına yapılan yükleme isteğinin türü:

  • media: Medya verilerini yükleyen basit yükleme.
  • resumable: En az iki isteklik bir seri kullanarak dosyayı devam ettirilebilir şekilde yükleyen devam ettirilebilir yükleme.

Yetkilendirme

Bu istek, aşağıdaki kapsamla yetkilendirme gerektiriyor:

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

Daha fazla bilgi için kimlik doğrulama ve yetkilendirme sayfasına bakın.

İstek içeriği

Bu yöntemle istek gövdesi sağlamayın.

Yanıt

Başarılı olursa bu yöntem aşağıdaki yapıya sahip bir yanıt gövdesi döndürür:

{
  "kind": "groupsmigration#groups",
  "responseCode": string
}
Mülk adı Değer Açıklama
kind string Bu öğe ekleme kaynağının türü. Değer: groupsmigration#groups
responseCode string

Bir taşıma isteği için API yanıtının durum kodu ve HTTP durum kodu. responseCode durum değerleri şunları içerir:

AUTHORIZATION FAILURE — Yöneticinin yetkilendirme kimlik bilgileri geçersiz. 401 HTTP durum kodu döndürülür.

BACKEND FAILURE — Sunucuda bir sorun vardır veya meşguldür. 503 HTTP durum kodu döndürülür. Üstel geri yükleme algoritması kullanarak başarısız çağrıyı yeniden denemeden önce kısa bir gecikme bekleyin.

INVALID MESSAGE FAILURE — E-posta iletisi geçersiz bir biçimde. Bir mesaj yanlış biçimlendirilmiş olduğu için reddedilirse 400 Bad Request HTTP durum kodu alırsınız. Geçersiz biçim örnekleri arasında şunlar bulunur:

  • İletide From, To ve Date alanları eksik olabilir.
  • Mesajdaki bir satır, CR+LF (yani "\r\n") stili bir yeni satır tarafından sonlandırılmazsa hata oluşur.
  • E-posta iletisi boş.
  • Taşıma işleminin hedef grubu mevcut değil veya "salt okuma" modunda. Salt okunur paylaşım modu hakkında daha fazla bilgi edinmek için Google Gruplar İşletme Sürümü paylaşım seçeneklerine göz atın.

SUCCESS - Posta, hesabın grup arşivinde başarıyla arşivlendi. 200 HTTP durum kodu döndürülür.

UNSUPPORTED_PARALLEL_OPERATION: Groups Migration API, aynı grup arşivine paralel mesaj eklemeyi desteklemez. Ayrıca Groups Migration API, toplu istekleri desteklemez. Ancak Groups Migration API, farklı grup arşivlerine e-posta ekleme için paralel istekleri destekler. 400 HTTP durum kodu döndürülür.