Archive: insert

Medya yükleme özelliğini kullanarak bir e-posta iletisini Google grubunun arşivine taşır.

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

  • Maksimum dosya boyutu: Maksimum e-posta ileti 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çimi başlıklı makaleyi inceleyin.

İ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. Grup sahibi, grubun e-posta adresini Yönetici konsolunu veya Directory API'yi kullanarak değiştirirse groupId değişkenindeki yeni e-posta adresini kullanmanız gerekir.
Gerekli sorgu parametreleri
uploadType string

Aşağıdaki değerlerden biri olan /upload URI'sine yönelik yükleme isteği türü:

  • media: Medya verilerini yükleyen basit yükleme.
  • resumable: Dosyayı en az iki istek dizisi kullanarak devam ettirilebilir şekilde yükleyen devam ettirilebilir yükleme.

Yetkilendirme

Bu istek için aşağıdaki kapsamda yetkilendirme gerekir:

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ğlamaz.

Yanıt

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

{
  "kind": "groupsmigration#groups",
  "responseCode": string
}
Mülk adı Değer Açıklama
kind string Bu, ne tür bir ekleme kaynağı olduğunu belirtir. Değer: groupsmigration#groups
responseCode string

HTTP durum kodu ile birlikte bir taşıma isteğine ait API yanıtının durum kodu. responseCode durum değerleri şunlardır:

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

BACKEND FAILURE: Sunucuyla ilgili bir sorun var veya sunucu meşgul. 503 HTTP durum kodu döndürülür. Başarısız aramayı tekrar denemeden önce, üsselik geri çekilme algoritması kullanarak küçük bir gecikme bekleyin.

INVALID MESSAGE FAILURE — E-posta iletisinin biçimi geçersiz. Bir mesaj, hatalı biçimlendirilmiş olarak reddedilirse 400 Bad Request HTTP durum kodu alırsınız. Geçersiz biçim örnekleri şunlardır:

  • İletideki From, To ve Date alanları eksik olabilir.
  • Mesaj içindeki bir satır, CR+LF (yani "\r\n") stili yeni satırla sonlandırılmazsa hata oluşur.
  • E-posta mesajı boş.
  • Taşıma işleminin hedef grubu mevcut değil veya "salt okuma" modunda. Salt okunur paylaşım modu hakkında daha fazla bilgi için Google Gruplar İşletme Sürümü paylaşım seçeneklerine bakı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 eklenmesini desteklemez. Ayrıca Grup Taşıma API'si 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.