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ıların kişi gruplarına özgü olmalıdır. Yinelenen adla bir grup oluşturulmaya çalışıldığında HTTP 409 hatası döndürülür.

Aynı kullanıcıya yönelik değişiklik istekleri, gecikme ve hata sayısında artış olmaması için 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

İsteğin gövdesi, aşağıdaki yapıya sahip veriler 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 döndürülecek alanları kısıtlamak için kullanılan bir alan maskesi. Ayarlanmazsa veya boş olarak ayarlanırsa varsayılan olarak metadata, groupType ve name olur. Geçerli alanlar şunlardır:

  • clientData
  • groupType
  • metadata
  • ad

Yanıt gövdesi

Başarılı olursa yanıt gövdesi, yeni oluşturulan 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ılavuzu'na bakın.