Method: people.updateContact

Mevcut bir ilgili kişinin iletişim verilerini güncelleme. Kişilerle ilgili olmayan hiçbir veri değiştirilmez. Güncellenecek kişideki temassız veriler yoksayılır. updateMask içinde belirtilen tüm alanlar değiştirilecek.

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

person.metadata.sources.etag, kişinin etiket düzeyinden farklıysa, sunucu "failedPrecondition" nedeniyle bir 400 hatası döndürür. Bu, kişinin verileri okunduktan sonra değiştiğini belirtir. Müşteriler en yeni kişiyi almalı ve güncellemelerini en yeni kişiyle birleştirmelidir.

memberships güncelleniyorsa ve kişide herhangi bir kişi grubu üyeliği belirtilmemişse sunucu bir 400 hatası döndürür.

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

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

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

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

Kişi için sunucu tarafından atanan kaynak adı. people/{person_id} biçimindeki bir ASCII dizesi.

Sorgu parametreleri

Parametreler
updatePersonFields

string (FieldMask format)

Zorunlu. Kişide güncellenecek alanları kısıtlayan bir alan maskesi. Virgülle ayırarak birden çok alan belirtilebilir. Güncellenen tüm alanlar değiştirilecek. 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
personFields

string (FieldMask format)

İsteğe bağlı. 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. Ayarlanmazsa varsayılan olarak tüm alanlar kullanılır. 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.

İ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ılavuzu'na bakın.