People API

Zapewnia dostęp do informacji na temat profili i kontaktów.

Usługa: people.googleapis.com

Aby wywołać tę usługę, zalecamy użycie dostarczonych przez Google bibliotek klienta. Jeśli do wywoływania tej usługi aplikacja musi używać własnych bibliotek, podczas tworzenia żądań do interfejsu API użyj podanych niżej informacji.

Dokument opisujący

Dokument opisujący to czytelna dla komputera specyfikacja opisująca interfejsy API REST i korzystanie z nich. Służy do tworzenia bibliotek klienta, wtyczek IDE i innych narzędzi, które współdziałają z interfejsami API Google. Jedna usługa może udostępniać wiele dokumentów opisujących. Ta usługa dostarcza następujący dokument opisujący interfejs API:

Punkt końcowy usługi

Punkt końcowy usługi to podstawowy adres URL, który określa adres sieciowy usługi interfejsu API. Jedna usługa może mieć wiele punktów końcowych. Ta usługa ma następujący punkt końcowy i wszystkie poniższe identyfikatory URI odnoszą się do tego punktu końcowego:

  • https://people.googleapis.com

Zasób REST: v1.contactGroups

Metody
batchGet GET /v1/contactGroups:batchGet
Pobierz listę grup kontaktów należących do uwierzytelnionego użytkownika przez określenie listy nazw zasobów grup kontaktów.
create POST /v1/contactGroups
Utwórz nową grupę kontaktów należącą do uwierzytelnionego użytkownika.
delete DELETE /v1/{resourceName=contactGroups/*}
Usuń istniejącą grupę kontaktów należącą do uwierzytelnionego użytkownika, podając nazwę zasobu grupy kontaktów.
get GET /v1/{resourceName=contactGroups/*}
Podaj nazwę zasobu grupy kontaktów, aby uzyskać konkretną grupę kontaktów należącą do uwierzytelnionego użytkownika.
list GET /v1/contactGroups
Wyświetl wszystkie grupy kontaktów należące do uwierzytelnionego użytkownika.
update PUT /v1/{contactGroup.resourceName=contactGroups/*}
Zaktualizuj nazwę istniejącej grupy kontaktów należącej do uwierzytelnionego użytkownika.

Zasób REST: v1.contactGroups.members

Metody
modify POST /v1/{resourceName=contactGroups/*}/members:modify
Modyfikowanie członków grupy kontaktów należącej do uwierzytelnionego użytkownika.

Zasób REST: v1.otherContacts

Metody
copyOtherContactToMyContactsGroup POST /v1/{resourceName=otherContacts/*}:copyOtherContactToMyContactsGroup

Kopiowanie „Inny kontakt” do nowego kontaktu w grupie „Moje Kontakty” użytkownika

Żądania mutacji do tego samego użytkownika powinny być wysyłane po kolei, aby uniknąć wydłużenia czasu oczekiwania i niepowodzeń.

list GET /v1/otherContacts
Wyświetl wszystkie „Inne kontakty”, czyli kontakty, które nie należą do grupy kontaktów.
search GET /v1/otherContacts:search
Podaje listę kontaktów z innych kontaktów uwierzytelnionego użytkownika, które pasują do zapytania.

Zasób REST: v1.people

Metody
batchCreateContacts POST /v1/people:batchCreateContacts

Utwórz grupę nowych kontaktów i zwróć wartości PersonResponse dla nowo

Żądania mutacji do tego samego użytkownika powinny być wysyłane po kolei, aby uniknąć wydłużenia czasu oczekiwania i niepowodzeń.

batchDeleteContacts POST /v1/people:batchDeleteContacts
Usuń grupę kontaktów.
batchUpdateContacts POST /v1/people:batchUpdateContacts
Zaktualizuj grupę kontaktów i zwróć mapę nazw zasobów do PersonResponse w przypadku zaktualizowanych kontaktów.
createContact POST /v1/people:createContact
Utwórz nowy kontakt i zwróć dla niego zasób osoby.
deleteContact DELETE /v1/{resourceName=people/*}:deleteContact
Usuń osobę kontaktową.
deleteContactPhoto DELETE /v1/{resourceName=people/*}:deleteContactPhoto
Usuń zdjęcie kontaktu.
get GET /v1/{resourceName=people/*}
Zawiera informacje o osobie przez określenie nazwy zasobu.
getBatchGet GET /v1/people:batchGet
Udostępnia informacje o liście konkretnych osób, określając listę nazw żądanych zasobów.
listDirectoryPeople GET /v1/people:listDirectoryPeople
Zawiera listę profili domen i kontaktów z domen w katalogu domeny uwierzytelnionego użytkownika.
searchContacts GET /v1/people:searchContacts
Wyświetla listę kontaktów w zgrupowanych kontaktach uwierzytelnionego użytkownika, które pasują do zapytania.
searchDirectoryPeople GET /v1/people:searchDirectoryPeople
Zawiera listę profili domen i kontaktów z domen w katalogu domeny uwierzytelnionego użytkownika, które pasują do zapytania.
updateContact PATCH /v1/{person.resourceName=people/*}:updateContact
Zaktualizuj dane kontaktowe istniejącej osoby kontaktowej.
updateContactPhoto PATCH /v1/{resourceName=people/*}:updateContactPhoto
Zaktualizuj zdjęcie kontaktu.

Zasób REST: v1.people.connections

Metody
list GET /v1/{resourceName=people/*}/connections
Zawiera listę kontaktów uwierzytelnionego użytkownika.