Method: people.batchCreateContacts

Bir grup yeni kişi oluşturun ve yeni kişi için PersonResponses'u döndürün

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/people:batchCreateContacts

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 
{
  "contacts": [
    {
      object (ContactToCreate)
    }
  ],
  "readMask": string,
  "sources": [
    enum (ReadSourceType)
  ]
}
Alanlar
contacts[]

object (ContactToCreate)

Zorunlu. Oluşturulacak kişi. Tek bir istekte en fazla 200 kişiye izin verir.
readMask

string (FieldMask format)

Zorunlu. Yanıtta her bir kişi için döndürülen alanları kısıtlayan bir alan maskesi. Virgülle ayırarak birden çok alan belirtilebilir. Okuma maskesi boş bırakılırsa post-mutate-get atlanır ve yanıtta hiçbir veri döndürülmez. Geçerli değerler şunlardır:

  • adresler
  • ageRanges
  • biyografiler
  • doğum günleri
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • etkinlikler
  • externalIds
  • cinsiyetler
  • imClients
  • ilgi alanları
  • locales
  • konumlar
  • memberships
  • meta veri
  • miscKeywords
  • isimler
  • takma adlar
  • meslekler
  • kuruluşlar
  • phoneNumbers
  • fotoğraflar
  • ilişkiler
  • sipAddresses
  • beceriler
  • urller
  • userDefined
sources[]

enum (ReadSourceType)

İsteğe bağlı. Değişiklik sonrası okumada döndürülecek kaynak türlerinin maskesi. Ayarlanmamışsa varsayılan olarak READ_SOURCE_TYPE_CONTACT ve READ_SOURCE_TYPE_PROFILE değerine ayarlanır.

Yanıt gövdesi

Başarısız olursa her geçersiz kişi için hata listesini içeren BatchCreateContactsErrorDetails değerini döndürür.

Kişi grubu oluşturma isteğine verilen yanıt.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "createdPeople": [
    {
      object (PersonResponse)
    }
  ]
}
Alanlar
createdPeople[]

object (PersonResponse)

readMask isteği boş olmadığı sürece, oluşturulan kişiler.

Yetkilendirme kapsamları

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

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

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

ContactToCreate

Yeni oluşturulan bir kaynağı doldurmak için kişi verilerini içeren bir sarmalayıcı.

JSON gösterimi 
{
  "contactPerson": {
    object (Person)
  }
}
Alanlar
contactPerson

object (Person)

Zorunlu. Yeni oluşturulmuş bir kaynağı dolduracak kişi verileri.