Method: people.updateContact

Mevcut bir kişi kişisinin iletişim verilerini güncelleyin. Kişi verilerinde hiçbir değişiklik yapılmaz. Güncellenecek kişinin iletişim bilgileri dışındaki verileri göz ardı edilir. updateMask içinde belirtilen tüm alanlar değiştirilecek.

Kişinin güncellenmesi için person.metadata.sources belirtilmediyse veya kişi kaynağı yoksa sunucu 400 hatası döndürür.

person.metadata.sources.etag değeri, kişinin etag'inden farklıysa bu, "failedPrecondition" nedenini belirten bir 400 hatası döndürür ve bu, kişinin verilerinin okunmasından bu yana değiştiğini gösterir. Müşteriler en son kullanıcıyı almalı ve güncellemelerini en son kullanıcıyla birleştirmelidir.

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

Kişi kaynakları için tek seferlik bir alan üzerinde birden fazla alan belirtilirse sunucu 400 hatası döndürür:

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

Artan gecikme ve hatalardan kaçınmak için aynı kullanıcıya ait istek 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

Kişi tarafından sunucu tarafından atanan 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 kullanılan alan maskesi. Alanları virgülle ayırarak birden fazla alanı belirtebilirsiniz. Güncellenen tüm alanlar değiştirilecek. Valid values are:

  • addresses
  • biyografiler
  • doğum günleri
  • calendarUrls
  • istemciverileri
  • e-postaAdresleri
  • etkinlikler
  • harici kimlikler
  • cinsiyetler
  • imİstemcileri
  • ilgi alanları
  • locales
  • yerler
  • memberships
  • ÇeşitliAnahtar Kelimeler
  • adlar
  • takma adlar
  • meslekler
  • organizations
  • telefonNumaraları
  • ilişkiler
  • sipAdresleri
  • urller
  • kullanıcı tanımlı
personFields

string (FieldMask format)

İsteğe bağlı. Her kişideki hangi alanların döndürüleceğini kısıtlayan bir alan maskesi. Alanları virgülle ayırarak birden fazla alanı belirtebilirsiniz. Ayarlanmamışsa varsayılan olarak tüm alanlar kullanılır. Valid values are:

  • addresses
  • yaş grupları
  • biyografiler
  • doğum günleri
  • calendarUrls
  • istemciverileri
  • kapakFotoğraflar
  • e-postaAdresleri
  • etkinlikler
  • harici kimlikler
  • cinsiyetler
  • imİstemcileri
  • ilgi alanları
  • locales
  • yerler
  • memberships
  • metadata
  • ÇeşitliAnahtar Kelimeler
  • adlar
  • takma adlar
  • meslekler
  • organizations
  • telefonNumaraları
  • fotoğraflar
  • ilişkiler
  • sipAdresleri
  • beceriler
  • urller
  • kullanıcı tanımlı
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 kullanılır.

İstek metni

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

Yanıt metni

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.