Interfejs Contact API został wyłączony 19 stycznia 2022 r. W tym przewodniku znajdziesz informacje o zmianach w polach, punktach końcowych i zakresach autoryzacji podczas migracji do People API.
Opis
W przypadku wszystkich funkcji interfejs People API ma takie same funkcje jak starsza wersja interfejsu Contact API, z wyjątkiem Innych kontaktów:
W nowym zakresie administratorzy mają uprawnienia tylko do odczytu w odniesieniu do „Innych kontaktów”. Przesyłanie sygnałów mutacji/zapisu z powrotem do „Innych kontaktów” nie jest obsługiwane, więc użytkownicy, którzy chcą zaktualizować pola danych, będą musieli dodać „Inny kontakt” jako „Mój kontakt”.
Za pomocą interfejsu API można odczytywać tylko podstawowe informacje kontaktowe z „Innych kontaktów”. Na przykład imię i nazwisko, adres e-mail i numer telefonu.
Dodatkowo stary zakres Kontaktów (https://www.google.com/m8/feeds), który zapewniał dostęp zarówno do kontaktów osobistych, jak i informacji z katalogu, został zastąpiony tymi zakresami:
- Aby uzyskać dostęp do kontaktów osobistych:
https://www.googleapis.com/auth/contacts - Aby uzyskać dostęp do informacji z katalogu:
https://www.googleapis.com/auth/directory.readonly
Kontakty
Mapowanie pól
| Pole kontaktu | Pole osoby |
|---|---|
| atom:content | biografie |
| atom:link rel='http://schemas.google.com/contacts/2008/rel#photo' | zdjęcia |
| atom:title | names |
| gContact:billingInformation | różne słowa kluczowe (type=OUTLOOK_BILLING_INFORMATION) |
| gContact:urodziny | urodziny |
| gContact:calendarLink | calendarUrls |
| gContact:serwer katalogów | różne słowa kluczowe (type=OUTLOOK_DIRECTORY_server) |
| gContact:event | zdarzenia |
| gContact:extendedProperty | clientData |
| gContact:externalId, | externalIds |
| gContact:fileAs | fileAses |
| gContact:gender | płeć |
| gContact:groupMembershipInfo | memberships.contactGroupMembership |
| gContact:hobby | zainteresowania |
| gContact:initials | WYCOFANE pseudonimy (type=INITIALS) |
| gContact:jot type='home' | różne słowa kluczowe (type=STRONA GŁÓWNA) |
| gContact:jot type='keywords', | różne słowa kluczowe (type=OUTLOOK_KEYWORD) |
| gContact:jot type='other' | różne słowa kluczowe (type=OTHER) |
| gContact:jot type='użytkownik', | miscKeywords (type=OUTLOOK_USER) |
| gContact:jot type='praca' | miscKeywords (type=WORK) |
| gContact:language | języki |
| gContact:imię i nazwisko panieńskie | WYCOFANE pseudonimy (type=MAIDEN_NAME) |
| gContact:mileage | różne słowa kluczowe (type=OUTLOOK_MILEAGE) |
| gContact:pseudonim | pseudonimy (typ=DEFAULT) |
| gContact:zawód | zawody |
| gContact:priorytet | różne słowa kluczowe (type=OUTLOOK_PRIORITY) |
| gContact:relation, | relacje |
| gContact:wrażliwość | różne słowa kluczowe (type=OUTLOOK_SENSITIVITY) |
| gContact:shortName | WYCOFANE pseudonimy (type=SHORT_NAME) |
| gContact:subject | różne słowa kluczowe (type=OUTLOOK_SUBJECT) |
| gContact:Pole Zdefiniowane przez użytkownika | userDefined |
| gContact:witryna | urls |
| gContact:yomiName | names.phonetic_full_name |
| gd:deleted | metadata.deleted |
| gd:email | emailAddresses |
| gd:im | imClients |
| gd:organizacja | organizations |
| gd:phoneNumber | phoneNumbers |
| gd:postalAddress | addresses.formattedValue |
| gd:gdzie | rezydencje |
| gd:structuredPostalAddress | adresy |
Punkty końcowe kontaktów osobistych
Odczyt
Wymaga zakresu https://www.googleapis.com/auth/contacts lub https://www.googleapis.com/auth/contacts.readonly.
- Odczytywanie pojedynczego konkretnego kontaktu
people.get - Odczytywanie kilku konkretnych kontaktów
people.getBatchGet - Odczytywanie kontaktów za pomocą
people.connections.list
Mutacja
Wymaga zakresu https://www.googleapis.com/auth/contacts. Zmienia wszystkie pola kontaktów
z wyjątkiem zdjęć.
- Utwórz kontakt, korzystając z
people.createContact - Zaktualizuj istniejący kontakt za pomocą narzędzia
people.updateContact - Usuń kontakt za pomocą narzędzia
people.deleteContact.
Zmiana zdjęcia
Wymaga zakresu https://www.googleapis.com/auth/contacts.
- Zaktualizuj zdjęcie kontaktu, używając pola
people.updateContactPhoto. - Usuń zdjęcie kontaktu za pomocą
people.deleteContactPhoto.
Inne punkty końcowe kontaktów
Odczyt
Inne kontakty są tylko do odczytu i zwracane są tylko pola names, emailAddresses oraz phoneNumbers.
Wymaga zakresu https://www.googleapis.com/auth/contacts.other.readonly.
- Odczytuj inne kontakty, używając konta
otherContacts.list.
Kopiuj
Wymaga zakresów https://www.googleapis.com/auth/contacts.other.readonly i https://www.googleapis.com/auth/contacts.
- Skopiuj inne kontakty, używając konta
otherContacts.copyOtherContactToMyContactsGroup.
Punkty końcowe globalnej listy adresów
Wymaga zakresu https://www.googleapis.com/auth/directory.readonly.
- Wyświetl wszystkie kontakty i profile z katalogu
people.listDirectoryPeople. - Wyszukiwanie kontaktów i profili z katalogu
people.searchDirectoryPeople.
Grupy kontaktów
Mapowanie pól
| Pole grupy kontaktów interfejsu API kontaktów | Pole grupy kontaktów interfejsu People API |
|---|---|
| atom:zaktualizowano | metadata.updateTime |
| atom:title | name |
| atom:content | name |
| gd:deleted | metadata.deleted |
| systemGroup | groupType=SYSTEM_CONTACT_GROUP |
Punkty końcowe
Odczyt
Wymaga zakresu https://www.googleapis.com/auth/contacts lub https://www.googleapis.com/auth/contacts.readonly.
- Aby znaleźć konkretną grupę kontaktów, użyj adresu
people.contactGroups.get - Wyświetl grupy kontaktów za pomocą
people.contactGroups.list
Mutacja
Wymaga zakresu https://www.googleapis.com/auth/contacts.
- Utwórz grupę kontaktów, korzystając z adresu
people.contactGroups.create - Aktualizowanie grupy kontaktów w aplikacji
people.contactGroups.update - Usuwanie grupy kontaktów przy użyciu adresu
people.contactGroups.delete Dodawanie kontaktów z grupy i usuwanie ich z niej przy użyciu aplikacji
people.contactGroups.members.modify
Zakresy autoryzacji
Starszy zakres https://www.google.com/m8/feeds jest aliasem zakresu https://www.googleapis.com/auth/contacts. Oznacza to, że obecne żądania OAuth ze starszego zakresu będą działać ze wszystkimi punktami końcowymi w People API, które wymagają zakresu https://www.googleapis.com/auth/contacts. Odczytywanie i zapisywanie kontaktów oraz grup kontaktów będzie działać ze starszym zakresem.
People API wymaga nowych zakresów, aby uzyskać dostęp do danych z katalogu „Inne kontakty”. Informacje o wymaganych zakresach znajdziesz powyżej.
Więcej informacji znajdziesz w artykule Autoryzowanie żądań.
Biblioteki klienta
- W przypadku Apps Script zapoznaj się z artykułem Advanced People Service (Zaawansowane usługi osób).
- Informacje o innych obsługiwanych językach znajdziesz w artykule Instalowanie bibliotek klienta.