Contacts API Taşıma Kılavuzu

Contacts API, 19 Ocak 2022'de kullanımdan kaldırıldı. People API'ye geçiş yaparken alanlar, uç noktalar ve yetkilendirme kapsamlarında yapılan değişiklikler hakkında bilgi edinmek için bu kılavuzdan yararlanın.

Genel bakış

People API, Diğer Kişiler için aşağıdaki istisnalar dışında tüm özellikler açısından eski Contacts API ile aynı işlevlere sahiptir:

  • Yöneticiler yeni kapsam kapsamında "Diğer Kişiler" için salt okuma izinlerine sahip olacak. Değişim/yazma sinyallerinin "Diğer Kişiler"e geri gönderilmesi desteklenmediğinden, veri alanlarını güncellemek isteyen kullanıcılarınızın Diğer Kişiyi Kişilerim olarak eklemesi gerekir.

  • API üzerinden yalnızca "Diğer Kişiler"e ilişkin temel iletişim bilgileri okunabilir. Örneğin, tam ad, e-posta adresi ve telefon numarası.

Ayrıca, hem özel kişilere hem de dizin bilgilerine erişim sağlayan eski Kişiler kapsamının (https://www.google.com/m8/feeds) yerini şu kapsamlar aldı:

  • Özel kişilere erişmek için: https://www.googleapis.com/auth/contacts
  • Dizin bilgilerine erişmek için: https://www.googleapis.com/auth/directory.readonly

Kişiler

Alan Eşleme

Kişi Alanı Kişi Alanı
atom:content biyografiler
atom:link rel='http://schemas.google.com/contacts/2008/rel#photo' fotoğraflar
atom:title names
gContact:billingInformation miscKeywords (tür=OUTLOOK_BILLING_INFORMATION)
gContact:doğum günü doğum günleri
gContact:calendarLink calendarUrls
gContact:directoryServer miscKeywords (tür=OUTLOOK_DIRECTORY_SERVER)
gContact:etkinlik etkinlikler
gContact:extendedÖzellik clientData
gContact:hariciId externalIds
gContact:dosyaAs fileAses
gContact:cinsiyet cinsiyetler
gContact:groupMembershipInfo memberships.contactGroupMembership
gContact:hobi ilgi alanları
gContact:initials KULLANIMDAN KALDIRILDI takma adlar (tür=INITIALS)
gContact:jot type='home' miscKeywords (type=EV)
gContact:jot type='keywords' Çeşitli Anahtar Kelimeler (tür=OUTLOOK_KEYWORD)
gContact:jot type='other' miscKeywords (type=OTHER)
gContact:jot type='user' miscKeywords (tür=OUTLOOK_USER)
gContact:not type='iş' Çeşitli Anahtar Kelimeler (tür=İŞ)
gContact:dil diller
gContact:maidenName KULLANIMDAN KALDIRILDI takma adlar (tür=MAIDEN_NAME)
gContact:mil miscKeywords (tür=OUTLOOK_MILEAGE)
gContact:takmaad takma adlar (tür=VARSAYILAN)
gContact:meslek meslek
gContact:öncelik Çeşitli Anahtar Kelimeler (tür=OUTLOOK_PRIORITY)
gContact:ilişkisi ilişkiler
gContact:hassasiyet miscKeywords (tür=OUTLOOK_SENSITIVITY)
gContact:shortName KULLANIMDAN KALDIRILDI takma adlar (tür=SHORT_NAME)
gContact:konu miscKeywords (tür=OUTLOOK_SUBJECT)
gContact:userDefinedField userDefined
gContact:web sitesi urls
gContact:yomiName names.phonetic_full_name
gd:silindi metadata.deleted
gd:email emailAddresses
gd:im imClients
gd:kuruluş organizations
gd:phoneNumber phoneNumbers
gd:postalAddress addresses.formattedValue
gd:nerede konutlar
gd:structuredPostalAddress adresler

Özel Kişiler Uç Noktaları

Okuma

https://www.googleapis.com/auth/contacts veya https://www.googleapis.com/auth/contacts.readonly kapsam gerektirir.

Değişiklik

https://www.googleapis.com/auth/contacts kapsam gerektirir. Fotoğraflar dışındaki tüm kişi alanlarını değiştirir.

Fotoğraf değişimi

https://www.googleapis.com/auth/contacts kapsam gerektirir.

Diğer Kişiler Uç Noktaları

Okuma

Diğer kişiler salt okunurdur ve yalnızca names, emailAddresses ve phoneNumbers alanları döndürülür.

https://www.googleapis.com/auth/contacts.other.readonly kapsam gerektirir.

Kopyala

https://www.googleapis.com/auth/contacts.other.readonly ve https://www.googleapis.com/auth/contacts kapsam gerektirir.

Genel Adres Listesi Uç Noktaları

https://www.googleapis.com/auth/directory.readonly kapsam gerektirir.

Kişi Grupları

Alan Eşleme

Contacts API Kişi Grubu Alanı Kişiler API'si Kişi Grubu Alanı
atom:güncellenmiş metadata.updateTime
atom:title name
atom:content name
gd:silindi metadata.deleted
systemGroup groupType=SYSTEM_CONTACT_GROUP

Uç noktalar

Okuma

https://www.googleapis.com/auth/contacts veya https://www.googleapis.com/auth/contacts.readonly kapsam gerektirir.

Değişiklik

https://www.googleapis.com/auth/contacts kapsam gerektirir.

Yetkilendirme kapsamları

Eski kapsam https://www.google.com/m8/feeds, https://www.googleapis.com/auth/contacts kapsamının takma adıdır. Başka bir deyişle, eski kapsamla mevcut OAuth izinleri, People API'de https://www.googleapis.com/auth/contacts kapsamını gerektiren tüm uç noktalar için kullanılabilir. Kişileri ve kişi gruplarını okuma ve yazma eski kapsamla çalışır.

People API, "Diğer Kişiler" veya Dizin verilerine erişmek için yeni kapsamlar gerektiriyor. Gereken kapsamlar için yukarıdaki ayrıntılara bakın.

Daha ayrıntılı bilgi için İstekleri Yetkilendirme başlıklı makaleyi inceleyin.

İstemci kitaplıkları