Method: contactGroups.create

Kimliği doğrulanmış kullanıcıya ait yeni bir kişi grubu oluşturun.

Oluşturulan kişi grubu adları, kullanıcının kişi gruplarına özgü olmalıdır. Yinelenen ada sahip bir grup oluşturma girişiminde HTTP 409 hatası döndürülür.

Gecikmenin ve hataların artmasını önlemek için aynı kullanıcıya yönelik değişiklik istekleri sırayla gönderilmelidir.

HTTP isteği

POST https://people.googleapis.com/v1/contactGroups

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek içeriği

İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi 
{
  "contactGroup": {
    object (ContactGroup)
  },
  "readGroupFields": string
}
Alanlar
contactGroup

object (ContactGroup)

Zorunlu. Oluşturulacak kişi grubu.
readGroupFields

string (FieldMask format)

İsteğe bağlı. Grupta hangi alanların döndürüleceğini kısıtlamak için kullanılan bir alan maskesi. Ayarlanmazsa veya boş olarak ayarlanırsa varsayılan olarak metadata, groupType ve name değerine ayarlanır. Geçerli alanlar şunlardır:

  • clientData
  • groupType
  • meta veri
  • ad

Yanıt gövdesi

Başarılı olursa yanıt gövdesi, yeni oluşturulmuş bir ContactGroup örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/contacts

Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.