Method: people.batchCreateContacts

Bir grup yeni kişi oluşturun ve yeni kişiler için PersonResponses bilgilerini

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

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

object (ContactToCreate)

Zorunlu. Oluşturulacak kişi. Tek bir istekte 200 adede kadar kişiye izin verir.
readMask

string (FieldMask format)

Zorunlu. Yanıtta her kişide hangi alanların döndürüleceğini sınırlayan 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. Valid values are:

  • addresses
  • ageRanges
  • biyografiler
  • doğum günleri
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • etkinlikler
  • externalIds
  • cinsiyetler
  • imClients
  • ilgi alanları
  • locales
  • konumlar
  • memberships
  • metadata
  • miscKeywords
  • names
  • takma adlar
  • meslekler
  • organizations
  • phoneNumbers
  • fotoğraflar
  • ilişkiler
  • sipAddresses
  • beceriler
  • urls
  • userDefined
sources[]

enum (ReadSourceType)

İsteğe bağlı. Okuma sonrasında hangi kaynak türlerinin döndürüleceğini gösteren maske. Ayarlanmamışsa varsayılan olarak READ_SOURCE_TYPE_CONTACT ve READ_SOURCE_TYPE_PROFILE olur.

Yanıt gövdesi

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

Toplu kişi 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ılavuzu'na bakın.

ContactToCreate

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

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

object (Person)

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