Method: people.batchUpdateContacts

Bir kişi grubunu güncelleme ve güncellenen kişiler için PersonResponses'a kaynak adları haritasını döndürme.

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:batchUpdateContacts

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

map (key: string, value: object (Person))

Zorunlu. Güncellenecek kişi verileriyle kaynak adlarının haritası. Tek bir istekte en fazla 200 kişiye izin verir.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
updateMask

string (FieldMask format)

Zorunlu. Kişide hangi alanların güncelleneceğini kısıtlamak için kullanılan bir alan maskesi. Virgülle ayırarak birden çok alan belirtilebilir. Belirtilen tüm alanlar değiştirilir veya her kullanıcı için boş bırakılırsa bu alanlar temizlenir. Geçerli değerler şunlardır:

  • adresler
  • biyografiler
  • doğum günleri
  • calendarUrls
  • clientData
  • emailAddresses
  • etkinlikler
  • externalIds
  • cinsiyetler
  • imClients
  • ilgi alanları
  • locales
  • konumlar
  • memberships
  • miscKeywords
  • isimler
  • takma adlar
  • meslekler
  • kuruluşlar
  • phoneNumbers
  • ilişkiler
  • sipAddresses
  • urller
  • userDefined
readMask

string (FieldMask format)

Zorunlu. Her bir kişide döndürülecek 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ı. 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 kişiye karşılık gelen hataların bir listesi olan BatchUpdateContactsErrorDetails değerini döndürür.

Kişi grubunu güncelleme isteğine verilen yanıt.

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

JSON gösterimi 
{
  "updateResult": {
    string: {
      object (PersonResponse)
    },
    ...
  }
}
Alanlar
updateResult

map (key: string, value: object (PersonResponse))

readMask isteği boş olmadığı sürece, güncellenen kişilerle kaynak adlarının haritası.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Yetkilendirme kapsamları

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

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

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