Ważne: przed wyłączeniem usługi Kontakty w marcu 2023 roku przez Apps Script przenieś skrypty z usługi Kontakty do usługi zaawansowanej People API.
16 grudnia 2022 roku Apps Script wycofał usługę Kontakty. Zamiast tego użyj zaawansowanej usługi People API. People API wykorzystuje nowszy protokół JSON i udostępnia zaawansowane funkcje, takie jak łączenie kontaktów z profilami.
Z tego przewodnika dowiesz się, które metody usługi Kontakty nie mają odpowiednika w zaawansowanej usłudze People API, których możesz użyć zamiast nich, i znajdziesz przykłady kodu do migracji typowych zadań. Więcej informacji znajdziesz w przewodniku po migracji interfejsu Contacts API.
Metody bez odpowiedników interfejsu People API
Poniżej znajdziesz listę metod getContacts
w usłudze Kontakty, które nie oferują analogicznych sposobów wyszukiwania kontaktów w zaawansowanej usłudze People API. Dzięki zaawansowanej usłudze People API możesz wyszukiwać według pól names
, nickNames
, emailAddresses
, phoneNumbers
i organizations
kontaktu, które pochodzą ze źródła CONTACT
.
Metody bez odpowiedników |
---|
|
Poniżej znajdziesz listę metod getContacts
z usługi Kontakty, które używają dodatkowego parametru label
. Możesz użyć searchContacts
w zaawansowanej usłudze People API, aby uzyskać kontakty według odpowiadającego mu pola, ale nie możesz ograniczyć wyszukiwania do konkretnej etykiety.
Metody z częściowymi odpowiednikami |
---|
|
Dodatkowe funkcje dostępne w interfejsie People API
Po przejściu na usługę zaawansowaną People API będziesz mieć dostęp do następujących funkcji interfejsu People API, które nie są dostępne w usłudze Kontakty:
- Wskaż źródło danych – gdy szukasz informacji o osobie, możesz określić, gdzie chcesz szukać – może to być na przykład kontakt w Google lub profil Google.
- Wyszukiwanie osób według ciągu zapytania – możesz zobaczyć listę profili i kontaktów pasujących do określonego ciągu.
- Żądania zbiorcze – możesz grupować wywołania interfejsu People API, aby skrócić czas wykonywania skryptu.
Przykłady kodu do typowych zadań
W tej sekcji wymienione są typowe czynności wykonywane w usłudze Kontakty. Przykładowy kod pokazuje, jak tworzyć zadania za pomocą zaawansowanej usługi People API.
Pobierz grupę kontaktów według nazwy
Poniższy przykładowy kod pokazuje, jak uzyskać grupę kontaktów według jej nazwy, która jest odpowiednikiem getContactGroup(name)
w usłudze Kontakty.
Znajdź kontakt, używając adresu e-mail
Poniższy przykładowy kod pokazuje, jak znaleźć kontakt przy użyciu jego adresu e-mail, który jest odpowiednikiem getContact(emailAddress)
w usłudze Kontakty.
Pobierz wszystkie kontakty
Poniższy przykładowy kod pokazuje, jak uzyskać wszystkie kontakty użytkownika, czyli odpowiednik getContacts()
w usłudze Kontakty.
Uzyskiwanie pełnego imienia i nazwiska kontaktu
Poniższy przykładowy kod pokazuje, jak uzyskać imię i nazwisko kontaktu, które jest odpowiednikiem getFullName()
w usłudze Kontakty.
Zobacz wszystkie numery telefonów kontaktu
Poniższy przykładowy kod pokazuje, jak uzyskać wszystkie numery telefonów kontaktu, co odpowiada numerowi getPhones()
w usłudze Kontakty.
Uzyskiwanie określonego numeru telefonu kontaktu
Poniższy przykładowy kod pokazuje, jak uzyskać konkretny numer telefonu do kontaktu, który jest odpowiednikiem getPhoneNumber()
w usłudze Kontakty.