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.

• Tek bir kişiyi okuma people.get
• Belirli kişileri okuma people.getBatchGet
• people.connections.list kullanarak kişileri okuma

Değişiklik

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

• people.createContact ile kişi oluşturun
• people.updateContact ile mevcut bir kişiyi güncelleme
• Bir kişiyi people.deleteContact kullanarak silebilirsiniz.

Fotoğraf değişimi

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

• people.updateContactPhoto kullanarak kişi fotoğrafını güncelleyin.
• people.deleteContactPhoto kullanarak kişi fotoğrafını silin.

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.

• otherContacts.list kullanarak diğer kişileri okuma

Kopyala

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

• otherContacts.copyOtherContactToMyContactsGroup kullanarak diğer kişileri kopyalayın.

Genel Adres Listesi Uç Noktaları

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

• Tüm dizin kişilerini ve profillerini listeleyin people.listDirectoryPeople.
• Dizin kişilerinde ve profillerinde arayın people.searchDirectoryPeople.

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.

• people.contactGroups.get ile belirli bir kişi grubu alma
• people.contactGroups.list kullanarak kişi gruplarını listeleme

Değişiklik

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

• people.contactGroups.create ile kişi grubu oluşturma
• people.contactGroups.update kullanarak kişi grubunu güncelleme
• people.contactGroups.delete kullanarak kişi grubunu silme

• people.contactGroups.members.modify kullanarak kişi grubuna kişi ekleme veya gruptan kişi kaldırma

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ı

• Apps Komut Dosyası için Gelişmiş Kişi Hizmeti başlıklı makaleyi inceleyin.
• Desteklenen diğer diller için İstemci Kitaplıklarını yükleme başlıklı makaleye bakın.