Method: people.batchUpdateContacts

Bir kişi grubunu güncelleyin ve güncellenmiş kişiler için PersonResponses'a kaynak adları haritasını döndürün.

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

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

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

Zorunlu. Kaynak adlarının, güncellenecek kişi verileriyle haritası. Tek bir istekte 200 adede kadar kişiye izin verir.

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

string (FieldMask format)

Zorunlu. Kişide güncellenecek alanları kısıtlayan 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 temizlenir. Valid values are:

  • addresses
  • biyografiler
  • doğum günleri
  • calendarUrls
  • clientData
  • emailAddresses
  • etkinlikler
  • externalIds
  • cinsiyetler
  • imClients
  • ilgi alanları
  • locales
  • konumlar
  • memberships
  • miscKeywords
  • names
  • takma adlar
  • meslekler
  • organizations
  • phoneNumbers
  • ilişkiler
  • sipAddresses
  • urls
  • userDefined
readMask

string (FieldMask format)

Zorunlu. 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ı. Döndürülecek kaynak türlerinin maskesi. Ayarlanmamışsa varsayılan olarak READ_SOURCE_TYPE_CONTACT ve READ_SOURCE_TYPE_PROFILE olur.

Yanıt gövdesi

İşlem başarılı olmazsa her bir kişiye karşılık gelen hata listesi olan BatchUpdateContactsErrorDetails değerini döndürür.

Bir 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, kaynak adlarının güncellenen kişilerle eşleştirilir.

"key": value çiftlerin 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ılavuzu'na bakın.