People API

Zapewnia dostęp do informacji o profilach i kontaktach.

Usługa: people.googleapis.com

Do korzystania z tej usługi zalecamy używanie bibliotek klienta udostępnionych przez Google. Jeśli aplikacja musi używać własnych bibliotek do wywoływania tej usługi, podczas wysyłania żądań do interfejsu API używaj tych informacji.

Dokument Discovery

Dokument Discovery 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ółpracują 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 usługi i wszystkie poniższe identyfikatory URI odnoszą się do tego punktu końcowego usługi:

  • https://people.googleapis.com

Zasób REST: v1.contactGroup

Metody
batchGet GET /v1/contactGroups:batchGet
Aby uzyskać listę grup kontaktów należących do uwierzytelnionego użytkownika, podaj listę 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, określając nazwę zasobu grupy kontaktów.
get GET /v1/{resourceName=contactGroups/*}
Aby znaleźć konkretną grupę kontaktów należącą do uwierzytelnionego użytkownika, podaj jej nazwę zasobu.
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.contactGroup.members

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

Zasób REST: v1.otherKontakty

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

Kopiuje „Inny kontakt” do nowego kontaktu w grupie „moje Kontakty” użytkownika

Żądania mutacji tego samego użytkownika powinny być przesyłane po kolei, co pozwoli uniknąć opóźnień i niepowodzeń.

list GET /v1/otherContacts
Wyświetl wszystkie „Inne kontakty”, czyli kontakty spoza grupy kontaktów.
search GET /v1/otherContacts:search
Zawiera listę kontaktów z pozostałych kontaktów uwierzytelnionego użytkownika pasujących do wyszukiwanego hasła.

Zasób REST: v1.people

Metody
batchCreateContacts POST /v1/people:batchCreateContacts

Utwórz grupę nowych kontaktów i zwróć odpowiedzi dla nowych osób

Żądania mutacji tego samego użytkownika powinny być przesyłane po kolei, co pozwoli uniknąć opóźnień i niepowodzeń.

batchDeleteContacts POST /v1/people:batchDeleteContacts
Usuń grupę kontaktów.
batchUpdateContacts POST /v1/people:batchUpdateContacts
Zaktualizuj grupę kontaktów i zwróć mapę z nazwami zasobów do PersonResponse w przypadku zaktualizowanych kontaktów.
createContact POST /v1/people:createContact
Utwórz nowy kontakt i zwróć informacje o osobie w przypadku tego kontaktu.
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, określając nazwę zasobu.
getBatchGet GET /v1/people:batchGet
Zawiera informacje o liście konkretnych osób, określając listę żądanych nazw zasobów.
listDirectoryPeople GET /v1/people:listDirectoryPeople
Zawiera listę profili domen i kontaktów z domeny w katalogu domeny uwierzytelnionego użytkownika.
searchContacts GET /v1/people:searchContacts
Zawiera listę kontaktów w zgrupowanych kontaktach uwierzytelnionego użytkownika pasujących do zapytania.
searchDirectoryPeople GET /v1/people:searchDirectoryPeople
Zawiera listę profili domen i kontaktów z domeny w katalogu domeny uwierzytelnionego użytkownika, które pasują do zapytania.
updateContact PATCH /v1/{person.resourceName=people/*}:updateContact
Zaktualizuj dane kontaktu dla 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 z uwierzytelnionego konta użytkownika.