Method: people.updateContact

Mevcut bir ilgili kişinin iletişim verilerini güncelleyin. Temassız veriler değiştirilmez. Güncellenecek kişideki iletişim dışı veriler yoksayılır. updateMask içinde belirtilen tüm alanlar değiştirilir.

Güncellenecek kişi için person.metadata.sources belirtilmezse veya kişi kaynağı yoksa sunucu 400 hatası döndürür.

person.metadata.sources.etag, kişinin etag'inden farklıysa sunucu "failedPrecondition" nedenli bir 400 hatası döndürür. Bu durum, kişinin verileri okunduğundan beri değiştiğini gösterir. Müşteriler en son kişiyi almalı ve güncellemelerini en son kişiyle birleştirmelidir. Aynı kişide art arda güncelleme yapılıyorsa hataları önlemek için updateContact yanıtındaki etag kullanılmalıdır.

memberships güncelleniyorsa ve kişi için iletişim grubu üyeliği belirtilmemişse sunucu 400 hatası döndürür.

İletişim kaynakları için tekil olan bir alanda birden fazla alan belirtilirse sunucu 400 hatası döndürür:

  • biyografiler
  • doğum günleri
  • cinsiyetler
  • isimler

Artan gecikmeyi ve hataları önlemek için aynı kullanıcıya yönelik değiştirme istekleri sırayla gönderilmelidir.

HTTP isteği

PATCH https://people.googleapis.com/v1/{person.resourceName=people/*}:updateContact

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
person.resourceName

string

Sunucu tarafından atanan kişinin kaynak adı. people/{person_id} biçiminde bir ASCII dizesi.

Sorgu parametreleri

Parametreler
updatePersonFields

string (FieldMask format)

Zorunlu. Kişideki hangi alanların güncelleneceğini kısıtlamak için bir alan maskesi. Birden fazla alan virgülle ayrılarak belirtilebilir. Güncellenen tüm alanlar değiştirilir. 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
personFields

string (FieldMask format)

İsteğe bağlı. Her kullanıcının hangi alanlarının döndürüleceğini kısıtlayan bir alan maskesi. Birden fazla alan virgülle ayrılarak belirtilebilir. Ayarlanmamışsa varsayılan olarak tüm alanlar gösterilir. 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.

İstek içeriği

İstek metni, Person öğesinin bir örneğini içerir.

Yanıt gövdesi

Başarılıysa yanıt metni, Person öğesinin bir ö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ılavuzuna bakın.