developers.google.com Open in urlscan Pro
2a00:1450:4001:800::200e Public Scan

Back to summary

URL:
https://developers.google.com/people/api/rest/v1/people.connections/list
Submission: On April 11 via manual (April 11th 2022, 12:04:49 pm UTC) from DE — Scanned from DE

Form analysis
1 forms found in the DOM

GET https://developers.google.com/s/results

<form class="devsite-search-form" action="https://developers.google.com/s/results" method="GET">
  <div class="devsite-search-container">
    <div class="devsite-searchbox">
      <input aria-activedescendant="" aria-autocomplete="list" aria-label="Search" aria-haspopup="false" aria-multiline="false" autocomplete="off" class="devsite-search-field devsite-search-query" name="q" placeholder="Search" role="searchbox"
        type="text" value="" aria-controls="devsite-search-popout-container-id-1">
      <div class="devsite-search-image material-icons" aria-hidden="true"></div>
    </div>
    <button type="button" search-open="" class="devsite-search-button devsite-header-icon-button button-flat material-icons" aria-label="Open search"></button>
  </div>
  <div class="devsite-popout" id="devsite-search-popout-container-id-1">
    <div class="devsite-popout-result devsite-suggest-results-container" devsite-hide=""></div>
  </div>
</form>

Text Content

people
 * People API


Language English Bahasa Indonesia Deutsch Español Français Português – Brasil
Русский 中文 – 简体 日本語 한국어
Option auswählenLanguage
 * Language
 * English
 * Bahasa Indonesia
 * Deutsch
 * Español
 * Français
 * Português – Brasil
 * Русский
 * 中文 – 简体
 * 日本語
 * 한국어

Anmelden
Guides Reference Samples Support Mehr



people
 * People API

 * Guides
 * Reference
 * Samples
 * Support

 * Overview
 * REST Resources
 * contactGroups
    * Overview
    * batchGet
    * create
    * delete
    * get
    * list
    * update

 * contactGroups.members
    * Overview
    * modify

 * otherContacts
    * Overview
    * copyOtherContactToMyContactsGroup
    * list
    * search

 * people
    * Overview
    * batchCreateContacts
    * batchDeleteContacts
    * batchUpdateContacts
    * createContact
    * deleteContact
    * deleteContactPhoto
    * get
    * getBatchGet
    * listDirectoryPeople
    * searchContacts
    * searchDirectoryPeople
    * updateContact
    * updateContactPhoto

 * people.connections
    * Overview
    * list

 * Types
 * BatchCreateContactsErrorDetails
 * BatchUpdateContactsErrorDetails
 * DirectoryMergeSourceType
 * DirectorySourceType
 * PersonResponse
 * ReadSourceType
 * RequestMask
 * SearchResponse
 * Status
 * Standard Features
 * Query Parameters
 * Client Library Reference
 * Browser
 * Go
 * Java
    * Core library
    * API library

 * .NET
    * Core library
    * API library

 * Node.js
 * PHP
 * Python
    * Core library
    * API library

 * Ruby


 * Auf dieser Seite
 * HTTP request
 * Path parameters
 * Query parameters
 * Request body
 * Response body
 * Authorization Scopes
 * SortOrder
   Testen!

Based on this session
 * Method: people.get
   Updated Jul 13, 2021
 * Authorize Requests
   Updated Feb 16, 2022
 * Read and Manage Contacts
   Updated Jan 10, 2022

 * Home
 * 
   Products
 * 
   Google Workspace for Developers
 * 
   People API
 * 
   Reference

War das hilfreich?



METHOD: PEOPLE.CONNECTIONS.LIST

 * Auf dieser Seite
 * HTTP request
 * Path parameters
 * Query parameters
 * Request body
 * Response body
 * Authorization Scopes
 * SortOrder
 * Jetzt testen
 * 

 * HTTP request
 * Path parameters
 * Query parameters
 * Request body
 * Response body
   * JSON representation
 * Authorization Scopes
 * SortOrder
 * Try it!



Provides a list of the authenticated user's contacts.

Sync tokens expire 7 days after the full sync. A request with an expired sync
token will result in a 410 error. In the case of such an error clients should
make a full sync request without a syncToken.

The first page of a full sync request has an additional quota. If the quota is
exceeded, a 429 error will be returned. This quota is fixed and can not be
increased.

When the syncToken is specified, resources deleted since the last sync will be
returned as a person with PersonMetadata.deleted set to true.

When the pageToken or syncToken is specified, all other request parameters must
match the first call.

Writes may have a propagation delay of several minutes for sync requests.
Incremental syncs are not intended for read-after-write use cases.

See example usage at List the user's contacts that have changed.


HTTP REQUEST

GET https://people.googleapis.com/v1/{resourceName=people/*}/connections

The URL uses gRPC Transcoding syntax.


PATH PARAMETERS

Parameters resourceName
(deprecated)

string

Required. The resource name to return connections for. Only people/me is valid.


QUERY PARAMETERS

Parameters pageToken

string

Optional. A page token, received from a previous response nextPageToken. Provide
this to retrieve the subsequent page.

When paginating, all other parameters provided to people.connections.list must
match the first call that provided the page token.

pageSize

integer

Optional. The number of connections to include in the response. Valid values are
between 1 and 1000, inclusive. Defaults to 100 if not set or set to 0.

sortOrder

enum (SortOrder)

Optional. The order in which the connections should be sorted. Defaults to
LAST_MODIFIED_ASCENDING.

requestSyncToken

boolean

Optional. Whether the response should return nextSyncToken on the last page of
results. It can be used to get incremental changes since the last request by
setting it on the request syncToken.

More details about sync behavior at people.connections.list.

syncToken

string

Optional. A sync token, received from a previous response nextSyncToken Provide
this to retrieve only the resources changed since the last request.

When syncing, all other parameters provided to people.connections.list must
match the first call that provided the sync token.

More details about sync behavior at people.connections.list.

requestMask
(deprecated)

object (RequestMask)

Optional. DEPRECATED (Please use personFields instead)

A mask to restrict results to a subset of person fields.

personFields

string (FieldMask format)

Required. A field mask to restrict which fields on each person are returned.
Multiple fields can be specified by separating them with commas. Valid values
are:

 * addresses
 * ageRanges
 * biographies
 * birthdays
 * calendarUrls
 * clientData
 * coverPhotos
 * emailAddresses
 * events
 * externalIds
 * genders
 * imClients
 * interests
 * locales
 * locations
 * memberships
 * metadata
 * miscKeywords
 * names
 * nicknames
 * occupations
 * organizations
 * phoneNumbers
 * photos
 * relations
 * sipAddresses
 * skills
 * urls
 * userDefined

sources[]

enum (ReadSourceType)

Optional. A mask of what source types to return. Defaults to
READ_SOURCE_TYPE_CONTACT and READ_SOURCE_TYPE_PROFILE if not set.


REQUEST BODY

The request body must be empty.


RESPONSE BODY

If successful, the response body contains data with the following structure:

The response to a request for the authenticated user's connections.

JSON representation

{
  "connections": [
    {
      object (Person)
    }
  ],
  "nextPageToken": string,
  "nextSyncToken": string,
  "totalPeople": integer,
  "totalItems": integer
}

Fields connections[]

object (Person)

The list of people that the requestor is connected to.

nextPageToken

string

A token, which can be sent as pageToken to retrieve the next page. If this field
is omitted, there are no subsequent pages.

nextSyncToken

string

A token, which can be sent as syncToken to retrieve changes since the last
request. Request must set requestSyncToken to return the sync token. When the
response is paginated, only the last page will contain nextSyncToken.

totalPeople
(deprecated)

integer

This item is deprecated!

DEPRECATED (Please use totalItems) The total number of people in the list
without pagination.

totalItems

integer

The total number of items in the list without pagination.


AUTHORIZATION SCOPES

Requires one of the following OAuth scopes:

 * https://www.googleapis.com/auth/contacts
 * https://www.googleapis.com/auth/contacts.readonly

For more information, see the Authorization guide.


SORTORDER

The order in which a list of connections should be sorted. This is only used if
sync is not requested.

Enums LAST_MODIFIED_ASCENDING Sort people by when they were changed; older
entries first. LAST_MODIFIED_DESCENDING Sort people by when they were changed;
newer entries first. FIRST_NAME_ASCENDING Sort people by first name.
LAST_NAME_ASCENDING Sort people by last name.


War das hilfreich?



BASED ON THIS SESSION





METHOD: PEOPLE.GET

View and manage contacts and domain profiles.

Aktualisiert: Jul 13, 2021


AUTHORIZE REQUESTS

View and manage contacts and domain profiles.

Aktualisiert: Feb 16, 2022


READ AND MANAGE CONTACTS

View and manage contacts and domain profiles.

Aktualisiert: Jan 10, 2022


Except as otherwise noted, the content of this page is licensed under the
Creative Commons Attribution 4.0 License, and code samples are licensed under
the Apache 2.0 License. For details, see the Google Developers Site Policies.
Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2021-07-20 UTC.

[{ "type": "thumb-down", "id": "missingTheInformationINeed", "label":"Missing
the information I need" },{ "type": "thumb-down", "id":
"tooComplicatedTooManySteps", "label":"Too complicated / too many steps" },{
"type": "thumb-down", "id": "outOfDate", "label":"Out of date" },{ "type":
"thumb-down", "id": "samplesCodeIssue", "label":"Samples / code issue" },{
"type": "thumb-down", "id": "otherDown", "label":"Other" }] [{ "type":
"thumb-up", "id": "easyToUnderstand", "label":"Easy to understand" },{ "type":
"thumb-up", "id": "solvedMyProblem", "label":"Solved my problem" },{ "type":
"thumb-up", "id": "otherUp", "label":"Other" }]
 * Stack Overflow
   Ask a question under the google-people tag


 * TERMS
   
   * Google API Services: User Data Policy


 * PROGRAMS
   
   * Women Techmakers
   * Google Developer Groups
   * Google Developers Experts
   * Accelerators
   * Google Developer Student Clubs


 * DEVELOPER CONSOLES
   
   * Google API Console
   * Google Cloud Platform Console
   * Google Play Console
   * Firebase Console
   * Actions on Google Console
   * Cast SDK Developer Console
   * Chrome Web Store Dashboard

 * Android
 * Chrome
 * Firebase
 * Google Cloud Platform
 * All products

 * Terms
 * Privacy
 * Sign up for the Google Developers newsletter Subscribe

Language English Bahasa Indonesia Deutsch Español Français Português – Brasil
Русский 中文 – 简体 日本語 한국어
Option auswählenLanguage
 * Language
 * English
 * Bahasa Indonesia
 * Deutsch
 * Español
 * Français
 * Português – Brasil
 * Русский
 * 中文 – 简体
 * 日本語
 * 한국어

Diese Seite verwendet Cookies von Google, um Dienste bereitzustellen und Traffic
zu analysieren.
Weitere DetailsOK

developers.google.com Open in urlscan Pro 2a00:1450:4001:800::200e Public Scan

Form analysis 1 forms found in the DOM

GET https://developers.google.com/s/results

Text Content

developers.google.com Open in urlscan Pro
2a00:1450:4001:800::200e Public Scan

Form analysis
1 forms found in the DOM