wyświetl listę wszystkich „Innych kontaktów”, czyli kontaktów, które nie należą do żadnej grupy kontaktów; „Inne kontakty” są zwykle tworzone automatycznie na podstawie interakcji.
Tokeny synchronizacji wygasają po 7 dniach po pełnej synchronizacji. Żądanie z wygasłym tokenem synchronizacji doprowadzi do błędu z błędem google.rpc.ErrorInfo i informacją o przyczynie „expirationD_SYNC_TOKEN”. W takim przypadku klient powinien wysłać pełne żądanie synchronizacji bez
.syncToken
Pierwsza strona żądania pełnej synchronizacji ma dodatkowy limit. Jeśli limit zostanie przekroczony, zwrócony zostanie błąd 429. Ten limit jest stały i nie można go zwiększyć.
Jeśli określisz właściwość
, zasoby usunięte od ostatniej synchronizacji zostaną zwrócone jako osoba z atrybutem syncToken
ustawionym na wartość Prawda.PersonMetadata.deleted
Jeśli podany jest parametr
lub pageToken
, pozostałe parametry żądania muszą odpowiadać pierwszemu wywołaniu.syncToken
Na propagację zapisów może wystąpić kilkuminutowe opóźnienie w przypadku żądań synchronizacji. Synchronizacje przyrostowe nie są przeznaczone do zastosowań typu odczyt po zapisie.
Przykład użycia znajdziesz w artykule Wyświetlanie listy innych kontaktów użytkownika, które uległy zmianie.
Żądanie HTTP
GET https://people.googleapis.com/v1/otherContacts
Adres URL używa składni transkodowania gRPC.
Parametry zapytania
Parametry | |
---|---|
pageToken |
Opcjonalnie. Token strony otrzymany z poprzedniej odpowiedzi W przypadku podziału na strony wszystkie pozostałe parametry podane w metodzie |
pageSize |
Opcjonalnie. Liczba „Innych kontaktów”, które mają być uwzględnione w odpowiedzi. Prawidłowe wartości mieszczą się w zakresie od 1 do 1000 włącznie. Jeśli zasada jest nieskonfigurowana lub ma wartość 0, domyślna wartość to 100. |
requestSyncToken |
Opcjonalnie. Określa, czy odpowiedź powinna zwrócić wartość Więcej informacji o synchronizacji znajdziesz na |
syncToken |
Opcjonalnie. Token synchronizacji otrzymany z poprzedniej odpowiedzi Podczas synchronizacji wszystkie pozostałe parametry podane do Więcej informacji o synchronizacji znajdziesz na |
readMask |
To pole jest wymagane. Maska pola określająca, które pola każdej osoby mają być zwracane. Można określić wiele pól, rozdzielając je przecinkami. Prawidłowe wartości zależą od użytego typu ReadSourceType. Jeśli używany jest parametr READ_SOURCE_TYPE_CONTACT, prawidłowe wartości to:
Jeśli używany jest profil READ_SOURCE_TYPE_PROFILE, prawidłowe wartości to:
|
sources[] |
Opcjonalnie. Maska typów źródeł do zwrócenia. Jeśli nie zostanie ustawiony, domyślna wartość to Możliwe wartości tego pola to: Podanie wartości |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Odpowiedź na żądanie „Innych kontaktów” uwierzytelnionego użytkownika.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"otherContacts": [
{
object ( |
Pola | |
---|---|
otherContacts[] |
Lista „Inne kontakty” zwrócona jako zasoby osoby. „Inne kontakty” obsługują ograniczony podzbiór pól. Szczegółowe informacje znajdziesz w sekcji ListOtherContactsRequest.request_mask. |
nextPageToken |
Token, który można wysłać jako |
nextSyncToken |
Token, który można wysłać jako |
totalSize |
Łączna liczba innych kontaktów na liście bez podziału na strony. |
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/contacts.other.readonly
Więcej informacji znajdziesz w przewodniku po autoryzacji.