Önemli: Apps Komut Dosyası, Mart 2023'te Kişiler hizmeti kullanımdan kaldırılmadan önce komut dosyalarınızı Kişiler hizmetinden People API gelişmiş hizmetine taşıyın.
Apps Komut Dosyası,16 Aralık 2022'de Kişiler hizmetini kullanımdan kaldırdı. Bunun yerine People API gelişmiş hizmetini kullanın. People API daha yeni bir JSON protokolü kullanır ve kişileri profillerle birleştirme gibi gelişmiş özellikler sunar.
People API'nin gelişmiş hizmetinde hangi Contacts hizmeti yöntemlerinin eşdeğeri olmadığını öğrenmek, bunların yerine ne kullanabileceğini öğrenmek ve sık kullanılan görevleri taşımak için kod örnekleri bulmak üzere bu kılavuzdan yararlanabilirsiniz. Daha fazla bilgi için Contacts API Taşıma Kılavuzu'na bakın.
People API eşdeğerleri olmayan yöntemler
Aşağıda, Kişiler hizmetinde bulunan ve People API gelişmiş hizmetinde kişi aramak için eşdeğer yöntemler bulunmayan getContacts
yöntemleri listelenmektedir. People API gelişmiş hizmetiyle kişilerin CONTACT
kaynağından gelen names
, nickNames
, emailAddresses
, phoneNumbers
ve organizations
alanlarına göre arama yapabilirsiniz.
Eşdeğeri olmayan yöntemler |
---|
|
Aşağıda, Kişiler hizmetinden ek bir label
parametresi kullanan getContacts
yöntemleri listelenmektedir. Kişileri eşdeğer alana göre almak için People API gelişmiş hizmetindeki searchContacts
aracını kullanabilirsiniz, ancak aramayı belirli bir etiketle sınırlandıramazsınız.
Kısmi eşdeğerleri olan yöntemler |
---|
|
People API ile kullanılabilen ek özellikler
People API gelişmiş hizmetine geçiş yaptığınızda, Kişiler hizmetinde bulunmayan aşağıdaki People API özelliklerine erişebilirsiniz:
- Veri kaynağını belirtin - Bir kişi hakkında bilgi ararken, nerede arama yapacağınızı (ör. Google kişisi veya Google profili) belirtebilirsiniz.
- Sorgu dizesine göre kişi arama - Belirli bir dizeyle eşleşen profillerin ve kişilerin listesini alabilirsiniz.
- Toplu istekler: Komut dosyası yürütme sürenizi kısaltmak için People API çağrılarınızı toplu hale getirebilirsiniz.
Sık kullanılan görevler için kod örnekleri
Bu bölümde, Kişiler hizmetindeki genel görevler listelenmiştir. Kod örnekleri, People API'nin gelişmiş hizmetini kullanarak görevlerin nasıl oluşturulacağını gösterir.
Ada göre kişi grubu alma
Aşağıdaki kod örneğinde, bir kişi grubunu adıyla nasıl alacağınız gösterilmektedir. Bu, Kişiler hizmetindeki getContactGroup(name)
eşdeğerdir.
E-posta adresiyle kişi al
Aşağıdaki kod örneğinde, Kişiler hizmetindeki getContact(emailAddress)
eşdeğeri olan e-posta adresinden bir kişinin nasıl bulunacağı gösterilmektedir.
Tüm kişileri al
Aşağıdaki kod örneğinde, bir kullanıcının tüm kişilerinin nasıl alınacağı gösterilmektedir. Bu, Kişiler hizmetindeki getContacts()
ile eşdeğerdir.
Bir kişinin tam adını alma
Aşağıdaki kod örneğinde, bir kişinin Kişiler hizmetindeki getFullName()
ile eşdeğer olan tam adının nasıl alınacağı gösterilmektedir.
Bir kişinin tüm telefon numaralarını alma
Aşağıdaki kod örneğinde, bir kişinin tüm telefon numaralarının nasıl alınacağı gösterilmektedir. Bu, Kişiler hizmetindeki getPhones()
ile eşdeğerdir.
Bir kişinin belirli bir telefon numarasını alma
Aşağıdaki kod örneğinde, bir kişi için belirli bir telefon numarasının nasıl alınacağı gösterilmektedir. Bu, Kişiler hizmetindeki getPhoneNumber()
ile eşdeğerdir.