CINXE.COM
Method: people.connections.list | People API | Google for Developers
<!doctype html> <html lang="en" dir="ltr"> <head> <meta name="google-signin-client-id" content="721724668570-nbkv1cfusk7kk4eni4pjvepaus73b13t.apps.googleusercontent.com"> <meta name="google-signin-scope" content="profile email https://www.googleapis.com/auth/developerprofiles https://www.googleapis.com/auth/developerprofiles.award"> <meta property="og:site_name" content="Google for Developers"> <meta property="og:type" content="website"><meta name="theme-color" content="#673ab7"><meta charset="utf-8"> <meta content="IE=Edge" http-equiv="X-UA-Compatible"> <meta name="viewport" content="width=device-width, initial-scale=1"> <link rel="manifest" href="/_pwa/developers/manifest.json" crossorigin="use-credentials"> <link rel="preconnect" href="//www.gstatic.com" crossorigin> <link rel="preconnect" href="//fonts.gstatic.com" crossorigin> <link rel="preconnect" href="//fonts.googleapis.com" crossorigin> <link rel="preconnect" href="//apis.google.com" crossorigin> <link rel="preconnect" href="//www.google-analytics.com" crossorigin><link rel="stylesheet" href="//fonts.googleapis.com/css?family=Google+Sans:400,500|Roboto:400,400italic,500,500italic,700,700italic|Roboto+Mono:400,500,700&display=swap"> <link rel="stylesheet" href="//fonts.googleapis.com/css2?family=Material+Icons&family=Material+Symbols+Outlined&display=block"><link rel="stylesheet" href="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/css/app.css"> <link rel="shortcut icon" href="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/favicon-new.png"> <link rel="apple-touch-icon" href="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/touchicon-180-new.png"><link rel="canonical" href="https://developers.google.com/people/api/rest/v1/people.connections/list"><link rel="search" type="application/opensearchdescription+xml" title="Google for Developers" href="https://developers.google.com/s/opensearch.xml"> <link rel="alternate" hreflang="en" href="https://developers.google.com/people/api/rest/v1/people.connections/list" /><link rel="alternate" hreflang="x-default" href="https://developers.google.com/people/api/rest/v1/people.connections/list" /><link rel="alternate" hreflang="ar" href="https://developers.google.com/people/api/rest/v1/people.connections/list?hl=ar" /><link rel="alternate" hreflang="bn" href="https://developers.google.com/people/api/rest/v1/people.connections/list?hl=bn" /><link rel="alternate" hreflang="zh-Hans" href="https://developers.google.com/people/api/rest/v1/people.connections/list?hl=zh-cn" /><link rel="alternate" hreflang="zh-Hant" href="https://developers.google.com/people/api/rest/v1/people.connections/list?hl=zh-tw" /><link rel="alternate" hreflang="fa" href="https://developers.google.com/people/api/rest/v1/people.connections/list?hl=fa" /><link rel="alternate" hreflang="fr" href="https://developers.google.com/people/api/rest/v1/people.connections/list?hl=fr" /><link rel="alternate" hreflang="de" href="https://developers.google.com/people/api/rest/v1/people.connections/list?hl=de" /><link rel="alternate" hreflang="he" href="https://developers.google.com/people/api/rest/v1/people.connections/list?hl=he" /><link rel="alternate" hreflang="hi" href="https://developers.google.com/people/api/rest/v1/people.connections/list?hl=hi" /><link rel="alternate" hreflang="id" href="https://developers.google.com/people/api/rest/v1/people.connections/list?hl=id" /><link rel="alternate" hreflang="it" href="https://developers.google.com/people/api/rest/v1/people.connections/list?hl=it" /><link rel="alternate" hreflang="ja" href="https://developers.google.com/people/api/rest/v1/people.connections/list?hl=ja" /><link rel="alternate" hreflang="ko" href="https://developers.google.com/people/api/rest/v1/people.connections/list?hl=ko" /><link rel="alternate" hreflang="pl" href="https://developers.google.com/people/api/rest/v1/people.connections/list?hl=pl" /><link rel="alternate" hreflang="pt-BR" href="https://developers.google.com/people/api/rest/v1/people.connections/list?hl=pt-br" /><link rel="alternate" hreflang="ru" href="https://developers.google.com/people/api/rest/v1/people.connections/list?hl=ru" /><link rel="alternate" hreflang="es-419" href="https://developers.google.com/people/api/rest/v1/people.connections/list?hl=es-419" /><link rel="alternate" hreflang="th" href="https://developers.google.com/people/api/rest/v1/people.connections/list?hl=th" /><link rel="alternate" hreflang="tr" href="https://developers.google.com/people/api/rest/v1/people.connections/list?hl=tr" /><link rel="alternate" hreflang="vi" href="https://developers.google.com/people/api/rest/v1/people.connections/list?hl=vi" /><title>Method: people.connections.list | People API | Google for Developers</title> <meta property="og:title" content="Method: people.connections.list | People API | Google for Developers"><meta property="og:url" content="https://developers.google.com/people/api/rest/v1/people.connections/list"><meta property="og:image" content="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/opengraph/deep-purple.png"> <meta property="og:image:width" content="1200"> <meta property="og:image:height" content="675"><meta property="og:locale" content="en"><meta name="twitter:card" content="summary_large_image"><script type="application/ld+json"> { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [{ "@type": "ListItem", "position": 1, "name": "People API", "item": "https://developers.google.com/people" },{ "@type": "ListItem", "position": 2, "name": "Method: people.connections.list", "item": "https://developers.google.com/people/api/rest/v1/people.connections/list" }] } </script> <link rel="stylesheet" href="/extras.css"></head> <body class="docs" template="page" theme="deep-purple" type="reference" itemscope itemtype="http://developers.google.com/ReferenceObject" layout="docs" concierge='closed' display-toc pending> <devsite-progress type="indeterminate" id="app-progress"></devsite-progress> <section class="devsite-wrapper"> <devsite-cookie-notification-bar></devsite-cookie-notification-bar><devsite-header role="banner"> <div class="devsite-header--inner nocontent"> <div class="devsite-top-logo-row-wrapper-wrapper"> <div class="devsite-top-logo-row-wrapper"> <div class="devsite-top-logo-row"> <button type="button" id="devsite-hamburger-menu" class="devsite-header-icon-button button-flat material-icons gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Navigation menu button" visually-hidden aria-label="Open menu"> </button> <div class="devsite-product-name-wrapper"> <a href="https://developers.google.com/people"> <div class="devsite-product-logo-container" size="medium" > <div class="devsite-product-logo material-icons" aria-hidden="true"> people </div> </div> </a> <span class="devsite-product-name"> <ul class="devsite-breadcrumb-list" > <li class="devsite-breadcrumb-item "> <a href="https://developers.google.com/people" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Upper Header" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail="People API" > People API </a> </li> </ul> </span> </div> <div class="devsite-top-logo-row-middle"> <div class="devsite-header-upper-tabs"> </div> <devsite-search enable-signin enable-search enable-suggestions enable-query-completion project-name="People API" tenant-name="Google for Developers" project-scope="/people" url-scoped="https://developers.google.com/s/results/people" > <form class="devsite-search-form" action="https://developers.google.com/s/results" method="GET"> <div class="devsite-search-container"> <button type="button" search-open class="devsite-search-button devsite-header-icon-button button-flat material-icons" aria-label="Open search"></button> <div class="devsite-searchbox"> <input aria-activedescendant="" aria-autocomplete="list" aria-label="Search" aria-expanded="false" aria-haspopup="listbox" autocomplete="off" class="devsite-search-field devsite-search-query" name="q" placeholder="Search" role="combobox" type="text" value="" > <div class="devsite-search-image material-icons" aria-hidden="true"> </div> <div class="devsite-search-shortcut-icon-container" aria-hidden="true"> <kbd class="devsite-search-shortcut-icon">/</kbd> </div> </div> </div> </form> <button type="button" search-close class="devsite-search-button devsite-header-icon-button button-flat material-icons" aria-label="Close search"></button> </devsite-search> </div> <devsite-language-selector> <ul role="presentation"> <li role="presentation"> <a role="menuitem" lang="en" >English</a> </li> <li role="presentation"> <a role="menuitem" lang="de" >Deutsch</a> </li> <li role="presentation"> <a role="menuitem" lang="es" >Español</a> </li> <li role="presentation"> <a role="menuitem" lang="es_419" >Español – América Latina</a> </li> <li role="presentation"> <a role="menuitem" lang="fr" >Français</a> </li> <li role="presentation"> <a role="menuitem" lang="id" >Indonesia</a> </li> <li role="presentation"> <a role="menuitem" lang="it" >Italiano</a> </li> <li role="presentation"> <a role="menuitem" lang="pl" >Polski</a> </li> <li role="presentation"> <a role="menuitem" lang="pt_br" >Português – Brasil</a> </li> <li role="presentation"> <a role="menuitem" lang="vi" >Tiếng Việt</a> </li> <li role="presentation"> <a role="menuitem" lang="tr" >Türkçe</a> </li> <li role="presentation"> <a role="menuitem" lang="ru" >Русский</a> </li> <li role="presentation"> <a role="menuitem" lang="he" >עברית</a> </li> <li role="presentation"> <a role="menuitem" lang="ar" >العربيّة</a> </li> <li role="presentation"> <a role="menuitem" lang="fa" >فارسی</a> </li> <li role="presentation"> <a role="menuitem" lang="hi" >हिंदी</a> </li> <li role="presentation"> <a role="menuitem" lang="bn" >বাংলা</a> </li> <li role="presentation"> <a role="menuitem" lang="th" >ภาษาไทย</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_cn" >中文 – 简体</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_tw" >中文 – 繁體</a> </li> <li role="presentation"> <a role="menuitem" lang="ja" >日本語</a> </li> <li role="presentation"> <a role="menuitem" lang="ko" >한국어</a> </li> </ul> </devsite-language-selector> <devsite-user enable-profiles fp-auth id="devsite-user"> <span class="button devsite-top-button" aria-hidden="true" visually-hidden>Sign in</span> </devsite-user> </div> </div> </div> <div class="devsite-collapsible-section "> <div class="devsite-header-background"> <div class="devsite-doc-set-nav-row"> <devsite-tabs class="lower-tabs"> <nav class="devsite-tabs-wrapper" aria-label="Lower tabs"> <tab > <a href="https://developers.google.com/people" track-metadata-eventdetail="https://developers.google.com/people" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - guides" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Guides" track-name="guides" > Guides </a> </tab> <tab class="devsite-active"> <a href="https://developers.google.com/people/api/rest" track-metadata-eventdetail="https://developers.google.com/people/api/rest" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - reference" track-metadata-module="primary nav" aria-label="Reference, selected" data-category="Site-Wide Custom Events" data-label="Tab: Reference" track-name="reference" > Reference </a> </tab> <tab > <a href="https://developers.google.com/people/support" track-metadata-eventdetail="https://developers.google.com/people/support" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - support" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Support" track-name="support" > Support </a> </tab> </nav> </devsite-tabs> </div> </div> </div> </div> </devsite-header> <devsite-book-nav scrollbars > <div class="devsite-book-nav-filter" > <span class="filter-list-icon material-icons" aria-hidden="true"></span> <input type="text" placeholder="Filter" aria-label="Type to filter" role="searchbox"> <span class="filter-clear-button hidden" data-title="Clear filter" aria-label="Clear filter" role="button" tabindex="0"></span> </div> <nav class="devsite-book-nav devsite-nav nocontent" aria-label="Side menu"> <div class="devsite-mobile-header"> <button type="button" id="devsite-close-nav" class="devsite-header-icon-button button-flat material-icons gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Close navigation" aria-label="Close navigation"> </button> <div class="devsite-product-name-wrapper"> <a href="https://developers.google.com/people"> <div class="devsite-product-logo-container" size="medium" > <div class="devsite-product-logo material-icons" aria-hidden="true"> people </div> </div> </a> <span class="devsite-product-name"> <ul class="devsite-breadcrumb-list" > <li class="devsite-breadcrumb-item "> <a href="https://developers.google.com/people" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Upper Header" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail="People API" > People API </a> </li> </ul> </span> </div> </div> <div class="devsite-book-nav-wrapper"> <div class="devsite-mobile-nav-top"> <ul class="devsite-nav-list"> <li class="devsite-nav-item"> <a href="/people" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Tab: Guides" track-name="guides" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Guides" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Guides </span> <span class="devsite-nav-icon material-icons" data-icon="forward" > </span> </a> </li> <li class="devsite-nav-item"> <a href="/people/api/rest" class="devsite-nav-title gc-analytics-event devsite-nav-has-children devsite-nav-active" data-category="Site-Wide Custom Events" data-label="Tab: Reference" track-name="reference" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Reference" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Reference </span> <span class="devsite-nav-icon material-icons" data-icon="forward" > </span> </a> </li> <li class="devsite-nav-item"> <a href="/people/support" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Tab: Support" track-name="support" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Support" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Support </span> <span class="devsite-nav-icon material-icons" data-icon="forward" > </span> </a> </li> </ul> </div> <div class="devsite-mobile-nav-bottom"> <ul class="devsite-nav-list" menu="_book"> <li class="devsite-nav-item"><a href="/people/api/rest" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest" ><span class="devsite-nav-text" tooltip>Overview</span></a></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> <span class="devsite-nav-text" tooltip>REST Resources</span> </div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> <span class="devsite-nav-text" tooltip>contactGroups</span> </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/people/api/rest/v1/contactGroups" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/contactGroups" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/contactGroups" ><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/people/api/rest/v1/contactGroups/batchGet" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/contactGroups/batchGet" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/contactGroups/batchGet" ><span class="devsite-nav-text" tooltip>batchGet</span></a></li><li class="devsite-nav-item"><a href="/people/api/rest/v1/contactGroups/create" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/contactGroups/create" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/contactGroups/create" ><span class="devsite-nav-text" tooltip>create</span></a></li><li class="devsite-nav-item"><a href="/people/api/rest/v1/contactGroups/delete" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/contactGroups/delete" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/contactGroups/delete" ><span class="devsite-nav-text" tooltip>delete</span></a></li><li class="devsite-nav-item"><a href="/people/api/rest/v1/contactGroups/get" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/contactGroups/get" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/contactGroups/get" ><span class="devsite-nav-text" tooltip>get</span></a></li><li class="devsite-nav-item"><a href="/people/api/rest/v1/contactGroups/list" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/contactGroups/list" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/contactGroups/list" ><span class="devsite-nav-text" tooltip>list</span></a></li><li class="devsite-nav-item"><a href="/people/api/rest/v1/contactGroups/update" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/contactGroups/update" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/contactGroups/update" ><span class="devsite-nav-text" tooltip>update</span></a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> <span class="devsite-nav-text" tooltip>contactGroups.members</span> </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/people/api/rest/v1/contactGroups.members" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/contactGroups.members" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/contactGroups.members" ><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/people/api/rest/v1/contactGroups.members/modify" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/contactGroups.members/modify" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/contactGroups.members/modify" ><span class="devsite-nav-text" tooltip>modify</span></a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> <span class="devsite-nav-text" tooltip>otherContacts</span> </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/people/api/rest/v1/otherContacts" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/otherContacts" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/otherContacts" ><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/people/api/rest/v1/otherContacts/copyOtherContactToMyContactsGroup" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/otherContacts/copyOtherContactToMyContactsGroup" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/otherContacts/copyOtherContactToMyContactsGroup" ><span class="devsite-nav-text" tooltip>copyOtherContactToMyContactsGroup</span></a></li><li class="devsite-nav-item"><a href="/people/api/rest/v1/otherContacts/list" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/otherContacts/list" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/otherContacts/list" ><span class="devsite-nav-text" tooltip>list</span></a></li><li class="devsite-nav-item"><a href="/people/api/rest/v1/otherContacts/search" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/otherContacts/search" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/otherContacts/search" ><span class="devsite-nav-text" tooltip>search</span></a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> <span class="devsite-nav-text" tooltip>people</span> </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/people/api/rest/v1/people" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/people" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/people" ><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/people/api/rest/v1/people/batchCreateContacts" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/people/batchCreateContacts" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/people/batchCreateContacts" ><span class="devsite-nav-text" tooltip>batchCreateContacts</span></a></li><li class="devsite-nav-item"><a href="/people/api/rest/v1/people/batchDeleteContacts" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/people/batchDeleteContacts" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/people/batchDeleteContacts" ><span class="devsite-nav-text" tooltip>batchDeleteContacts</span></a></li><li class="devsite-nav-item"><a href="/people/api/rest/v1/people/batchUpdateContacts" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/people/batchUpdateContacts" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/people/batchUpdateContacts" ><span class="devsite-nav-text" tooltip>batchUpdateContacts</span></a></li><li class="devsite-nav-item"><a href="/people/api/rest/v1/people/createContact" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/people/createContact" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/people/createContact" ><span class="devsite-nav-text" tooltip>createContact</span></a></li><li class="devsite-nav-item"><a href="/people/api/rest/v1/people/deleteContact" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/people/deleteContact" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/people/deleteContact" ><span class="devsite-nav-text" tooltip>deleteContact</span></a></li><li class="devsite-nav-item"><a href="/people/api/rest/v1/people/deleteContactPhoto" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/people/deleteContactPhoto" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/people/deleteContactPhoto" ><span class="devsite-nav-text" tooltip>deleteContactPhoto</span></a></li><li class="devsite-nav-item"><a href="/people/api/rest/v1/people/get" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/people/get" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/people/get" ><span class="devsite-nav-text" tooltip>get</span></a></li><li class="devsite-nav-item"><a href="/people/api/rest/v1/people/getBatchGet" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/people/getBatchGet" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/people/getBatchGet" ><span class="devsite-nav-text" tooltip>getBatchGet</span></a></li><li class="devsite-nav-item"><a href="/people/api/rest/v1/people/listDirectoryPeople" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/people/listDirectoryPeople" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/people/listDirectoryPeople" ><span class="devsite-nav-text" tooltip>listDirectoryPeople</span></a></li><li class="devsite-nav-item"><a href="/people/api/rest/v1/people/searchContacts" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/people/searchContacts" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/people/searchContacts" ><span class="devsite-nav-text" tooltip>searchContacts</span></a></li><li class="devsite-nav-item"><a href="/people/api/rest/v1/people/searchDirectoryPeople" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/people/searchDirectoryPeople" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/people/searchDirectoryPeople" ><span class="devsite-nav-text" tooltip>searchDirectoryPeople</span></a></li><li class="devsite-nav-item"><a href="/people/api/rest/v1/people/updateContact" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/people/updateContact" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/people/updateContact" ><span class="devsite-nav-text" tooltip>updateContact</span></a></li><li class="devsite-nav-item"><a href="/people/api/rest/v1/people/updateContactPhoto" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/people/updateContactPhoto" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/people/updateContactPhoto" ><span class="devsite-nav-text" tooltip>updateContactPhoto</span></a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> <span class="devsite-nav-text" tooltip>people.connections</span> </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/people/api/rest/v1/people.connections" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/people.connections" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/people.connections" ><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/people/api/rest/v1/people.connections/list" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/people.connections/list" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/people.connections/list" ><span class="devsite-nav-text" tooltip>list</span></a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> <span class="devsite-nav-text" tooltip>Types</span> </div></li> <li class="devsite-nav-item"><a href="/people/api/rest/v1/BatchCreateContactsErrorDetails" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/BatchCreateContactsErrorDetails" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/BatchCreateContactsErrorDetails" ><span class="devsite-nav-text" tooltip>BatchCreateContactsErrorDetails</span></a></li> <li class="devsite-nav-item"><a href="/people/api/rest/v1/BatchUpdateContactsErrorDetails" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/BatchUpdateContactsErrorDetails" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/BatchUpdateContactsErrorDetails" ><span class="devsite-nav-text" tooltip>BatchUpdateContactsErrorDetails</span></a></li> <li class="devsite-nav-item"><a href="/people/api/rest/v1/DirectoryMergeSourceType" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/DirectoryMergeSourceType" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/DirectoryMergeSourceType" ><span class="devsite-nav-text" tooltip>DirectoryMergeSourceType</span></a></li> <li class="devsite-nav-item"><a href="/people/api/rest/v1/DirectorySourceType" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/DirectorySourceType" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/DirectorySourceType" ><span class="devsite-nav-text" tooltip>DirectorySourceType</span></a></li> <li class="devsite-nav-item"><a href="/people/api/rest/v1/PersonResponse" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/PersonResponse" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/PersonResponse" ><span class="devsite-nav-text" tooltip>PersonResponse</span></a></li> <li class="devsite-nav-item"><a href="/people/api/rest/v1/ReadSourceType" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/ReadSourceType" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/ReadSourceType" ><span class="devsite-nav-text" tooltip>ReadSourceType</span></a></li> <li class="devsite-nav-item"><a href="/people/api/rest/v1/RequestMask" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/RequestMask" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/RequestMask" ><span class="devsite-nav-text" tooltip>RequestMask</span></a></li> <li class="devsite-nav-item"><a href="/people/api/rest/v1/SearchResponse" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/SearchResponse" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/SearchResponse" ><span class="devsite-nav-text" tooltip>SearchResponse</span></a></li> <li class="devsite-nav-item"><a href="/people/api/rest/v1/Status" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/api/rest/v1/Status" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/api/rest/v1/Status" ><span class="devsite-nav-text" tooltip>Status</span></a></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> <span class="devsite-nav-text" tooltip>Standard features</span> </div></li> <li class="devsite-nav-item"><a href="/people/v1/query-parameters" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /people/v1/query-parameters" track-type="bookNav" track-name="click" track-metadata-eventdetail="/people/v1/query-parameters" ><span class="devsite-nav-text" tooltip>Query parameters</span></a></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> <span class="devsite-nav-text" tooltip>Client library reference</span> </div></li> <li class="devsite-nav-item devsite-nav-external"><a href="https://github.com/google/google-api-javascript-client/blob/master/docs/reference.md" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: https://github.com/google/google-api-javascript-client/blob/master/docs/reference.md" track-type="bookNav" track-name="click" track-metadata-eventdetail="https://github.com/google/google-api-javascript-client/blob/master/docs/reference.md" ><span class="devsite-nav-text" tooltip>Browser</span><span class="devsite-nav-icon material-icons" data-icon="external" data-title="External" aria-hidden="true"></span></a></li> <li class="devsite-nav-item devsite-nav-external"><a href="https://pkg.go.dev/google.golang.org/api/people/v1" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: https://pkg.go.dev/google.golang.org/api/people/v1" track-type="bookNav" track-name="click" track-metadata-eventdetail="https://pkg.go.dev/google.golang.org/api/people/v1" ><span class="devsite-nav-text" tooltip>Go</span><span class="devsite-nav-icon material-icons" data-icon="external" data-title="External" aria-hidden="true"></span></a></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> <span class="devsite-nav-text" tooltip>Java</span> </div><ul class="devsite-nav-section"><li class="devsite-nav-item devsite-nav-external"><a href="https://googleapis.dev/java/google-api-client/latest/" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: https://googleapis.dev/java/google-api-client/latest/" track-type="bookNav" track-name="click" track-metadata-eventdetail="https://googleapis.dev/java/google-api-client/latest/" ><span class="devsite-nav-text" tooltip>Core library</span><span class="devsite-nav-icon material-icons" data-icon="external" data-title="External" aria-hidden="true"></span></a></li><li class="devsite-nav-item devsite-nav-external"><a href="https://developers.google.com/resources/api-libraries/documentation/people/v1/java/latest/" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: https://developers.google.com/resources/api-libraries/documentation/people/v1/java/latest/" track-type="bookNav" track-name="click" track-metadata-eventdetail="https://developers.google.com/resources/api-libraries/documentation/people/v1/java/latest/" ><span class="devsite-nav-text" tooltip>API library</span><span class="devsite-nav-icon material-icons" data-icon="external" data-title="External" aria-hidden="true"></span></a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> <span class="devsite-nav-text" tooltip>.NET</span> </div><ul class="devsite-nav-section"><li class="devsite-nav-item devsite-nav-external"><a href="https://developers.google.com/api-client-library/dotnet/reference/1.10.0/annotated" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: https://developers.google.com/api-client-library/dotnet/reference/1.10.0/annotated" track-type="bookNav" track-name="click" track-metadata-eventdetail="https://developers.google.com/api-client-library/dotnet/reference/1.10.0/annotated" ><span class="devsite-nav-text" tooltip>Core library</span><span class="devsite-nav-icon material-icons" data-icon="external" data-title="External" aria-hidden="true"></span></a></li><li class="devsite-nav-item devsite-nav-external"><a href="https://developers.google.com/resources/api-libraries/documentation/people/v1/csharp/latest/" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: https://developers.google.com/resources/api-libraries/documentation/people/v1/csharp/latest/" track-type="bookNav" track-name="click" track-metadata-eventdetail="https://developers.google.com/resources/api-libraries/documentation/people/v1/csharp/latest/" ><span class="devsite-nav-text" tooltip>API library</span><span class="devsite-nav-icon material-icons" data-icon="external" data-title="External" aria-hidden="true"></span></a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-external"><a href="https://googleapis.dev/nodejs/googleapis/latest/people/classes/People.html" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: https://googleapis.dev/nodejs/googleapis/latest/people/classes/People.html" track-type="bookNav" track-name="click" track-metadata-eventdetail="https://googleapis.dev/nodejs/googleapis/latest/people/classes/People.html" ><span class="devsite-nav-text" tooltip>Node.js</span><span class="devsite-nav-icon material-icons" data-icon="external" data-title="External" aria-hidden="true"></span></a></li> <li class="devsite-nav-item devsite-nav-external"><a href="https://developers.google.com/resources/api-libraries/documentation/people/v1/php/latest/" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: https://developers.google.com/resources/api-libraries/documentation/people/v1/php/latest/" track-type="bookNav" track-name="click" track-metadata-eventdetail="https://developers.google.com/resources/api-libraries/documentation/people/v1/php/latest/" ><span class="devsite-nav-text" tooltip>PHP</span><span class="devsite-nav-icon material-icons" data-icon="external" data-title="External" aria-hidden="true"></span></a></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> <span class="devsite-nav-text" tooltip>Python</span> </div><ul class="devsite-nav-section"><li class="devsite-nav-item devsite-nav-external"><a href="http://googleapis.github.io/google-api-python-client/docs/epy/index.html" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: http://googleapis.github.io/google-api-python-client/docs/epy/index.html" track-type="bookNav" track-name="click" track-metadata-eventdetail="http://googleapis.github.io/google-api-python-client/docs/epy/index.html" ><span class="devsite-nav-text" tooltip>Core library</span><span class="devsite-nav-icon material-icons" data-icon="external" data-title="External" aria-hidden="true"></span></a></li><li class="devsite-nav-item devsite-nav-external"><a href="http://googleapis.github.io/google-api-python-client/docs/dyn/people_v1.html" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: http://googleapis.github.io/google-api-python-client/docs/dyn/people_v1.html" track-type="bookNav" track-name="click" track-metadata-eventdetail="http://googleapis.github.io/google-api-python-client/docs/dyn/people_v1.html" ><span class="devsite-nav-text" tooltip>API library</span><span class="devsite-nav-icon material-icons" data-icon="external" data-title="External" aria-hidden="true"></span></a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-external"><a href="https://googleapis.dev/ruby/google-api-client/latest/Google/Apis/PeopleV1.html" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: https://googleapis.dev/ruby/google-api-client/latest/Google/Apis/PeopleV1.html" track-type="bookNav" track-name="click" track-metadata-eventdetail="https://googleapis.dev/ruby/google-api-client/latest/Google/Apis/PeopleV1.html" ><span class="devsite-nav-text" tooltip>Ruby</span><span class="devsite-nav-icon material-icons" data-icon="external" data-title="External" aria-hidden="true"></span></a></li> </ul> </div> </div> </nav> </devsite-book-nav> <section id="gc-wrapper"> <main role="main" class="devsite-main-content" has-book-nav > <devsite-content> <article class="devsite-article"> <div class="devsite-article-meta nocontent" role="navigation"> <ul class="devsite-breadcrumb-list" aria-label="Breadcrumb"> <li class="devsite-breadcrumb-item "> <a href="https://developers.google.com/" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail="" > Home </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/products" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="2" track-type="globalNav" track-name="breadcrumb" track-metadata-position="2" track-metadata-eventdetail="" > Products </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/workspace" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="3" track-type="globalNav" track-name="breadcrumb" track-metadata-position="3" track-metadata-eventdetail="Google Workspace" > Google Workspace </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/people" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="4" track-type="globalNav" track-name="breadcrumb" track-metadata-position="4" track-metadata-eventdetail="People API" > People API </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/people/api/rest" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="5" track-type="globalNav" track-name="breadcrumb" track-metadata-position="5" track-metadata-eventdetail="" > Reference </a> </li> </ul> <devsite-thumb-rating position="header"> </devsite-thumb-rating> </div> <h1 class="devsite-page-title" tabindex="-1"> Method: people.connections.list </h1> <devsite-feature-tooltip ack-key="AckCollectionsBookmarkTooltipDismiss" analytics-category="Site-Wide Custom Events" analytics-action-show="Callout Profile displayed" analytics-action-close="Callout Profile dismissed" analytics-label="Create Collection Callout" class="devsite-page-bookmark-tooltip nocontent" dismiss-button="true" id="devsite-collections-dropdown" dismiss-button-text="Dismiss" close-button-text="Got it"> <devsite-bookmark></devsite-bookmark> <span slot="popout-heading"> Stay organized with collections </span> <span slot="popout-contents"> Save and categorize content based on your preferences. </span> </devsite-feature-tooltip> <div class="devsite-page-title-meta"><devsite-view-release-notes></devsite-view-release-notes></div> <devsite-toc class="devsite-nav" depth="2" devsite-toc-embedded > </devsite-toc> <div class="devsite-article-body clearfix "> <meta itemprop="name" content="list"> <meta itemprop="path" content="/people/api/rest/v1/people.connections/list"> <section id="/people/api/rest/v1/people.connections/list"> <ul class="toc"> <li><a href="#body.HTTP_TEMPLATE">HTTP request</a></li> <li><a href="#body.PATH_PARAMETERS">Path parameters</a></li> <li><a href="#body.QUERY_PARAMETERS">Query parameters</a></li> <li><a href="#body.request_body">Request body</a></li> <li><a href="#body.response_body">Response body</a> <ul> <li><a href="#body.ListConnectionsResponse.SCHEMA_REPRESENTATION">JSON representation</a></li> </ul> </li> <li><a href="#body.aspect">Authorization scopes</a></li> <li><a href="#SortOrder">SortOrder</a></li> <li><a href="#try-it">Try it!</a></li> </ul> <section id="google.people.v1.PeopleService.ListConnections"> </section> <section id="description"> <p>Provides a list of the authenticated user's contacts.</p><p>Sync tokens expire 7 days after the full sync. A request with an expired sync token will get an error with an <a href="https://cloud.google.com/apis/design/errors#error_info">google.rpc.ErrorInfo</a> with reason "EXPIRED_SYNC_TOKEN". In the case of such an error clients should make a full sync request without a <code translate="no" dir="ltr"><a href="/people/api/rest/v1/people.connections/list#body.QUERY_PARAMETERS.sync_token"><code translate="no" dir="ltr">syncToken</code></a></code>.</p><p>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.</p><p>When the <code translate="no" dir="ltr"><a href="/people/api/rest/v1/people.connections/list#body.QUERY_PARAMETERS.sync_token"><code translate="no" dir="ltr">syncToken</code></a></code> is specified, resources deleted since the last sync will be returned as a person with <code translate="no" dir="ltr"><a href="/people/api/rest/v1/people#Person.PersonMetadata.FIELDS.deleted"><code translate="no" dir="ltr">PersonMetadata.deleted</code></a></code> set to true.</p><p>When the <code translate="no" dir="ltr"><a href="/people/api/rest/v1/people.connections/list#body.QUERY_PARAMETERS.page_token"><code translate="no" dir="ltr">pageToken</code></a></code> or <code translate="no" dir="ltr"><a href="/people/api/rest/v1/people.connections/list#body.QUERY_PARAMETERS.sync_token"><code translate="no" dir="ltr">syncToken</code></a></code> is specified, all other request parameters must match the first call.</p><p>Writes may have a propagation delay of several minutes for sync requests. Incremental syncs are not intended for read-after-write use cases.</p><p>See example usage at <a href="/people/v1/contacts#list_the_users_contacts_that_have_changed">List the user's contacts that have changed</a>.</p> </section> <section id="body"> <section id="body.HTTP_TEMPLATE"> <h3 id="http-request" data-text="HTTP request" tabindex="-1">HTTP request</h3> <p><code translate="no" dir="ltr">GET https://people.googleapis.com/v1/{resourceName=people/*}/connections</code></p><p>The URL uses <a href="https://google.aip.dev/127">gRPC Transcoding</a> syntax.</p> </section> <section id="body.PATH_PARAMETERS"> <h3 id="path-parameters" data-text="Path parameters" tabindex="-1">Path parameters</h3> <table class="properties responsive fixed" id="body.PATH_PARAMETERS-table"> <colgroup> <col width="25%"> <col> </colgroup> <thead> <tr> <th colspan="2">Parameters</th> </tr> </thead> <tbody> <tr id="body.PATH_PARAMETERS.resource_name"> <td><code translate="no" dir="ltr">resourceName<br><b>(deprecated)</b></code></td> <td> <p><code class="apitype" translate="no" dir="ltr">string</code></p> <p>Required. The resource name to return connections for. Only <code translate="no" dir="ltr">people/me</code> is valid.</p> </td> </tr> </tbody> </table> </section> <section id="body.QUERY_PARAMETERS"> <h3 id="query-parameters" data-text="Query parameters" tabindex="-1">Query parameters</h3> <table class="properties responsive fixed" id="body.QUERY_PARAMETERS-table"> <colgroup> <col width="25%"> <col> </colgroup> <thead> <tr> <th colspan="2">Parameters</th> </tr> </thead> <tbody> <tr id="body.QUERY_PARAMETERS.page_token"> <td><code translate="no" dir="ltr">pageToken</code></td> <td> <p><code class="apitype" translate="no" dir="ltr">string</code></p> <p>Optional. A page token, received from a previous response <code translate="no" dir="ltr"><a href="/people/api/rest/v1/people.connections/list#body.ListConnectionsResponse.FIELDS.next_page_token"><code translate="no" dir="ltr">nextPageToken</code></a></code>. Provide this to retrieve the subsequent page.</p><p>When paginating, all other parameters provided to <code translate="no" dir="ltr"><a href="/people/api/rest/v1/people.connections/list#google.people.v1.PeopleService.ListConnections"><code translate="no" dir="ltr">people.connections.list</code></a></code> must match the first call that provided the page token.</p> </td> </tr> <tr id="body.QUERY_PARAMETERS.page_size"> <td><code translate="no" dir="ltr">pageSize</code></td> <td> <p><code class="apitype" translate="no" dir="ltr">integer</code></p> <p>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.</p> </td> </tr> <tr id="body.QUERY_PARAMETERS.sort_order"> <td><code translate="no" dir="ltr">sortOrder</code></td> <td> <p><code class="apitype" translate="no" dir="ltr">enum (<code translate="no" dir="ltr"><a href="/people/api/rest/v1/people.connections/list#SortOrder">SortOrder</a></code>)</code></p> <p>Optional. The order in which the connections should be sorted. Defaults to <code translate="no" dir="ltr">LAST_MODIFIED_ASCENDING</code>.</p> </td> </tr> <tr id="body.QUERY_PARAMETERS.request_sync_token"> <td><code translate="no" dir="ltr">requestSyncToken</code></td> <td> <p><code class="apitype" translate="no" dir="ltr">boolean</code></p> <p>Optional. Whether the response should return <code translate="no" dir="ltr"><a href="/people/api/rest/v1/people.connections/list#body.ListConnectionsResponse.FIELDS.next_sync_token"><code translate="no" dir="ltr">nextSyncToken</code></a></code> on the last page of results. It can be used to get incremental changes since the last request by setting it on the request <code translate="no" dir="ltr"><a href="/people/api/rest/v1/people.connections/list#body.QUERY_PARAMETERS.sync_token"><code translate="no" dir="ltr">syncToken</code></a></code>.</p><p>More details about sync behavior at <code translate="no" dir="ltr"><a href="/people/api/rest/v1/people.connections/list#google.people.v1.PeopleService.ListConnections"><code translate="no" dir="ltr">people.connections.list</code></a></code>.</p> </td> </tr> <tr id="body.QUERY_PARAMETERS.sync_token"> <td><code translate="no" dir="ltr">syncToken</code></td> <td> <p><code class="apitype" translate="no" dir="ltr">string</code></p> <p>Optional. A sync token, received from a previous response <code translate="no" dir="ltr"><a href="/people/api/rest/v1/people.connections/list#body.ListConnectionsResponse.FIELDS.next_sync_token"><code translate="no" dir="ltr">nextSyncToken</code></a></code> Provide this to retrieve only the resources changed since the last request.</p><p>When syncing, all other parameters provided to <code translate="no" dir="ltr"><a href="/people/api/rest/v1/people.connections/list#google.people.v1.PeopleService.ListConnections"><code translate="no" dir="ltr">people.connections.list</code></a></code> must match the first call that provided the sync token.</p><p>More details about sync behavior at <code translate="no" dir="ltr"><a href="/people/api/rest/v1/people.connections/list#google.people.v1.PeopleService.ListConnections"><code translate="no" dir="ltr">people.connections.list</code></a></code>.</p> </td> </tr> <tr id="body.QUERY_PARAMETERS.request_mask"> <td><code translate="no" dir="ltr">requestMask<br><b>(deprecated)</b></code></td> <td> <p><code class="apitype" translate="no" dir="ltr">object (<code translate="no" dir="ltr"><a href="/people/api/rest/v1/RequestMask">RequestMask</a></code>)</code></p> <p>Optional. <strong>DEPRECATED</strong> (Please use <code translate="no" dir="ltr">personFields</code> instead)</p><p>A mask to restrict results to a subset of person fields.</p> </td> </tr> <tr id="body.QUERY_PARAMETERS.person_fields"> <td><code translate="no" dir="ltr">personFields</code></td> <td> <p><code class="apitype" translate="no" dir="ltr">string (<code translate="no" dir="ltr"><a href="https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask">FieldMask</a></code> format)</code></p> <p>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:</p> <ul> <li>addresses</li> <li>ageRanges</li> <li>biographies</li> <li>birthdays</li> <li>calendarUrls</li> <li>clientData</li> <li>coverPhotos</li> <li>emailAddresses</li> <li>events</li> <li>externalIds</li> <li>genders</li> <li>imClients</li> <li>interests</li> <li>locales</li> <li>locations</li> <li>memberships</li> <li>metadata</li> <li>miscKeywords</li> <li>names</li> <li>nicknames</li> <li>occupations</li> <li>organizations</li> <li>phoneNumbers</li> <li>photos</li> <li>relations</li> <li>sipAddresses</li> <li>skills</li> <li>urls</li> <li>userDefined</li> </ul> </td> </tr> <tr id="body.QUERY_PARAMETERS.sources"> <td><code translate="no" dir="ltr">sources[]</code></td> <td> <p><code class="apitype" translate="no" dir="ltr">enum (<code translate="no" dir="ltr"><a href="/people/api/rest/v1/ReadSourceType">ReadSourceType</a></code>)</code></p> <p>Optional. A mask of what source types to return. Defaults to <code translate="no" dir="ltr"><a href="/people/api/rest/v1/ReadSourceType#ENUM_VALUES.READ_SOURCE_TYPE_CONTACT">READ_SOURCE_TYPE_CONTACT</a></code> and <code translate="no" dir="ltr"><a href="/people/api/rest/v1/ReadSourceType#ENUM_VALUES.READ_SOURCE_TYPE_PROFILE">READ_SOURCE_TYPE_PROFILE</a></code> if not set.</p> </td> </tr> </tbody> </table> </section> <section id="body.request_body"> <h3 id="request-body" data-text="Request body" tabindex="-1">Request body</h3> <p>The request body must be empty.</p> </section> <section id="body.response_body"> <h3 id="response-body" data-text="Response body" tabindex="-1">Response body</h3> <section id="body.ListConnectionsResponse"> <section id="body.ListConnectionsResponse.description"> <p>The response to a request for the authenticated user's connections.</p> <p>If successful, the response body contains data with the following structure:</p> </section> <section id="body.ListConnectionsResponse.SCHEMA_REPRESENTATION"> <table class="properties responsive fixed"> <thead> <tr> <th>JSON representation</th> </tr> </thead> <tbody> <tr> <td style="margin:0;padding:0;"><div></div><devsite-code><pre style="border: 0;margin: 0;" translate="no" dir="ltr" is-upgraded><span class="pun">{</span> <span class="str">"connections"</span><span class="pun">: </span><span class="pun">[</span> <span class="pun">{</span> <span class="kwd">object (<code translate="no" dir="ltr"><a href="/people/api/rest/v1/people#Person">Person</a></code>)</span> <span class="pun">}</span> <span class="pun">]</span><span class="pun">,</span> <span class="str">"nextPageToken"</span><span class="pun">: </span><span class="kwd">string</span><span class="pun">,</span> <span class="str">"nextSyncToken"</span><span class="pun">: </span><span class="kwd">string</span><span class="pun">,</span> <span class="str">"totalPeople"</span><span class="pun">: </span><span class="kwd">integer</span><span class="pun">,</span> <span class="str">"totalItems"</span><span class="pun">: </span><span class="kwd">integer</span> <span class="pun">}</span></pre></devsite-code></td> </tr> </tbody> </table> </section> <section id="body.ListConnectionsResponse.FIELDS"> <table class="properties responsive fixed" id="body.ListConnectionsResponse.FIELDS-table"> <colgroup> <col width="25%"> <col> </colgroup> <thead> <tr> <th colspan="2">Fields</th> </tr> </thead> <tbody> <tr id="body.ListConnectionsResponse.FIELDS.connections"> <td><code translate="no" dir="ltr">connections[]</code></td> <td> <p><code class="apitype" translate="no" dir="ltr">object (<code translate="no" dir="ltr"><a href="/people/api/rest/v1/people#Person">Person</a></code>)</code></p> <p>The list of people that the requestor is connected to.</p> </td> </tr> <tr id="body.ListConnectionsResponse.FIELDS.next_page_token"> <td><code translate="no" dir="ltr">nextPageToken</code></td> <td> <p><code class="apitype" translate="no" dir="ltr">string</code></p> <p>A token, which can be sent as <code translate="no" dir="ltr">pageToken</code> to retrieve the next page. If this field is omitted, there are no subsequent pages.</p> </td> </tr> <tr id="body.ListConnectionsResponse.FIELDS.next_sync_token"> <td><code translate="no" dir="ltr">nextSyncToken</code></td> <td> <p><code class="apitype" translate="no" dir="ltr">string</code></p> <p>A token, which can be sent as <code translate="no" dir="ltr">syncToken</code> to retrieve changes since the last request. Request must set <code translate="no" dir="ltr">requestSyncToken</code> to return the sync token. When the response is paginated, only the last page will contain <code translate="no" dir="ltr">nextSyncToken</code>.</p> </td> </tr> <tr id="body.ListConnectionsResponse.FIELDS.total_people"> <td><code translate="no" dir="ltr">totalPeople<br><b>(deprecated)</b></code></td> <td> <p><code class="apitype" translate="no" dir="ltr">integer</code></p> <aside class="warning"><p>This item is deprecated!</p></aside> <p><strong>DEPRECATED</strong> (Please use totalItems) The total number of people in the list without pagination.</p> </td> </tr> <tr id="body.ListConnectionsResponse.FIELDS.total_items"> <td><code translate="no" dir="ltr">totalItems</code></td> <td> <p><code class="apitype" translate="no" dir="ltr">integer</code></p> <p>The total number of items in the list without pagination.</p> </td> </tr> </tbody> </table> </section> </section> </section> <section id="body.aspect"> <h3 id="authorization-scopes" data-text="Authorization scopes" tabindex="-1">Authorization scopes</h3> <p>Requires one of the following OAuth scopes:</p> <ul> <li><code translate="no" dir="ltr">https://www.googleapis.com/auth/contacts</code></li> <li><code translate="no" dir="ltr">https://www.googleapis.com/auth/contacts.readonly</code></li> </ul><p>For more information, see the <a href="/workspace/guides/configure-oauth-consent">Authorization guide</a>.</p> </section> </section> <section id="SortOrder"> <h2 id="sortorder" data-text="SortOrder" tabindex="-1">SortOrder</h2> <section id="SortOrder.description"> <p>The order in which a list of connections should be sorted. This is only used if sync is not requested.</p> </section> <section id="SortOrder.ENUM_VALUES"> <table class="constants responsive fixed" id="SortOrder.ENUM_VALUES-table"> <colgroup> <col width="25%"> <col> </colgroup> <thead> <tr> <th colspan="2">Enums</th> </tr> </thead> <tbody> <tr id="SortOrder.ENUM_VALUES.LAST_MODIFIED_ASCENDING"> <td><code class="apitype" translate="no" dir="ltr">LAST_MODIFIED_ASCENDING</code></td> <td>Sort people by when they were changed; older entries first.</td> </tr> <tr id="SortOrder.ENUM_VALUES.LAST_MODIFIED_DESCENDING"> <td><code class="apitype" translate="no" dir="ltr">LAST_MODIFIED_DESCENDING</code></td> <td>Sort people by when they were changed; newer entries first.</td> </tr> <tr id="SortOrder.ENUM_VALUES.FIRST_NAME_ASCENDING"> <td><code class="apitype" translate="no" dir="ltr">FIRST_NAME_ASCENDING</code></td> <td>Sort people by first name.</td> </tr> <tr id="SortOrder.ENUM_VALUES.LAST_NAME_ASCENDING"> <td><code class="apitype" translate="no" dir="ltr">LAST_NAME_ASCENDING</code></td> <td>Sort people by last name.</td> </tr> </tbody> </table> </section> </section> <section id="try-it"> <div class="devsite-apix"> <div class='apis-explorer' data-discovery-rest-url='https://people.googleapis.com/$discovery/rest?version=v1' data-method-id='people.people.connections.list' data-params=''></div> </div> </section> </section> <devsite-hats-survey class="nocontent" hats-id="mGsnyVGzf0eGRuQsCn30XwdoA8ve" listnr-id="717201"></devsite-hats-survey> </div> <devsite-recommendations display="in-page" hidden yield> </devsite-recommendations> <devsite-thumb-rating position="footer"> </devsite-thumb-rating> <devsite-recommendations id="recommendations-link" yield></devsite-recommendations> <div class="devsite-floating-action-buttons"> </div> </article> <devsite-content-footer class="nocontent"> <p>Except as otherwise noted, the content of this page is licensed under the <a href="https://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 License</a>, and code samples are licensed under the <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache 2.0 License</a>. For details, see the <a href="https://developers.google.com/site-policies">Google Developers Site Policies</a>. Java is a registered trademark of Oracle and/or its affiliates.</p> <p>Last updated 2024-08-06 UTC.</p> </devsite-content-footer> <devsite-notification > </devsite-notification> <div class="devsite-content-data"> <template class="devsite-content-data-template"> [[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-08-06 UTC."],[],[]] </template> </div> </devsite-content> </main> <devsite-footer-promos class="devsite-footer"> <nav class="devsite-footer-promos nocontent" aria-label="Promotions"> <ul class="devsite-footer-promos-list"> <li class="devsite-footer-promo"> <a href="http://stackoverflow.com/questions/tagged/google-people" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 1)" > <picture> <img class="devsite-footer-promo-icon" src="/static/site-assets/logo-stack-overflow.svg" loading="lazy" alt="Stack Overflow"> </picture> <span class="devsite-footer-promo-label"> Stack Overflow </span> </a> <div class="devsite-footer-promo-description">Ask a question under the google-people tag</div> </li> </ul> </nav> </devsite-footer-promos> <devsite-footer-linkboxes class="devsite-footer"> <nav class="devsite-footer-linkboxes nocontent" aria-label="Footer links"> <ul class="devsite-footer-linkboxes-list"> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Terms</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="/terms/api-services-user-data-policy" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)" > Google API Services: User Data Policy </a> </li> </ul> </li> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Programs</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="//www.womentechmakers.com" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)" > Women Techmakers </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/community/gdg" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)" > Google Developer Groups </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/community/experts" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)" > Google Developer Experts </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/community/accelerators" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 4)" > Accelerators </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/community/gdsc" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 5)" > Google Developer Student Clubs </a> </li> </ul> </li> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Developer consoles</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="//console.developers.google.com" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)" > Google API Console </a> </li> <li class="devsite-footer-linkbox-item"> <a href="//console.cloud.google.com" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)" > Google Cloud Platform Console </a> </li> <li class="devsite-footer-linkbox-item"> <a href="//play.google.com/apps/publish" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)" > Google Play Console </a> </li> <li class="devsite-footer-linkbox-item"> <a href="//console.firebase.google.com" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 4)" > Firebase Console </a> </li> <li class="devsite-footer-linkbox-item"> <a href="//console.actions.google.com" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 5)" > Actions on Google Console </a> </li> <li class="devsite-footer-linkbox-item"> <a href="//cast.google.com/publish" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 6)" > Cast SDK Developer Console </a> </li> <li class="devsite-footer-linkbox-item"> <a href="//chrome.google.com/webstore/developer/dashboard" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 7)" > Chrome Web Store Dashboard </a> </li> <li class="devsite-footer-linkbox-item"> <a href="//console.home.google.com" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 8)" > Google Home Developer Console </a> </li> </ul> </li> </ul> </nav> </devsite-footer-linkboxes> <devsite-footer-utility class="devsite-footer"> <div class="devsite-footer-utility nocontent"> <nav class="devsite-footer-sites" aria-label="Other Google Developers websites"> <a href="https://developers.google.com/" class="devsite-footer-sites-logo-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Google Developers Link"> <picture> <img class="devsite-footer-sites-logo" src="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/lockup-google-for-developers.svg" loading="lazy" alt="Google Developers"> </picture> </a> <ul class="devsite-footer-sites-list"> <li class="devsite-footer-sites-item"> <a href="//developer.android.com" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Android Link" > Android </a> </li> <li class="devsite-footer-sites-item"> <a href="//developer.chrome.com/home" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Chrome Link" > Chrome </a> </li> <li class="devsite-footer-sites-item"> <a href="//firebase.google.com" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Firebase Link" > Firebase </a> </li> <li class="devsite-footer-sites-item"> <a href="//cloud.google.com" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Google Cloud Platform Link" > Google Cloud Platform </a> </li> <li class="devsite-footer-sites-item"> <a href="//ai.google.dev/" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Google AI Link" > Google AI </a> </li> <li class="devsite-footer-sites-item"> <a href="/products" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer All products Link" > All products </a> </li> </ul> </nav> <nav class="devsite-footer-utility-links" aria-label="Utility links"> <ul class="devsite-footer-utility-list"> <li class="devsite-footer-utility-item "> <a class="devsite-footer-utility-link gc-analytics-event" href="/terms/site-terms" data-category="Site-Wide Custom Events" data-label="Footer Terms link" > Terms </a> </li> <li class="devsite-footer-utility-item "> <a class="devsite-footer-utility-link gc-analytics-event" href="//policies.google.com/privacy" data-category="Site-Wide Custom Events" data-label="Footer Privacy link" > Privacy </a> </li> <li class="devsite-footer-utility-item glue-cookie-notification-bar-control"> <a class="devsite-footer-utility-link gc-analytics-event" href="#" data-category="Site-Wide Custom Events" data-label="Footer Manage cookies link" aria-hidden="true" > Manage cookies </a> </li> <li class="devsite-footer-utility-item devsite-footer-utility-button"> <span class="devsite-footer-utility-description">Sign up for the Google for Developers newsletter</span> <a class="devsite-footer-utility-link gc-analytics-event" href="/newsletter/subscribe" data-category="Site-Wide Custom Events" data-label="Footer Subscribe link" > Subscribe </a> </li> </ul> <devsite-language-selector> <ul role="presentation"> <li role="presentation"> <a role="menuitem" lang="en" >English</a> </li> <li role="presentation"> <a role="menuitem" lang="de" >Deutsch</a> </li> <li role="presentation"> <a role="menuitem" lang="es" >Español</a> </li> <li role="presentation"> <a role="menuitem" lang="es_419" >Español – América Latina</a> </li> <li role="presentation"> <a role="menuitem" lang="fr" >Français</a> </li> <li role="presentation"> <a role="menuitem" lang="id" >Indonesia</a> </li> <li role="presentation"> <a role="menuitem" lang="it" >Italiano</a> </li> <li role="presentation"> <a role="menuitem" lang="pl" >Polski</a> </li> <li role="presentation"> <a role="menuitem" lang="pt_br" >Português – Brasil</a> </li> <li role="presentation"> <a role="menuitem" lang="vi" >Tiếng Việt</a> </li> <li role="presentation"> <a role="menuitem" lang="tr" >Türkçe</a> </li> <li role="presentation"> <a role="menuitem" lang="ru" >Русский</a> </li> <li role="presentation"> <a role="menuitem" lang="he" >עברית</a> </li> <li role="presentation"> <a role="menuitem" lang="ar" >العربيّة</a> </li> <li role="presentation"> <a role="menuitem" lang="fa" >فارسی</a> </li> <li role="presentation"> <a role="menuitem" lang="hi" >हिंदी</a> </li> <li role="presentation"> <a role="menuitem" lang="bn" >বাংলা</a> </li> <li role="presentation"> <a role="menuitem" lang="th" >ภาษาไทย</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_cn" >中文 – 简体</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_tw" >中文 – 繁體</a> </li> <li role="presentation"> <a role="menuitem" lang="ja" >日本語</a> </li> <li role="presentation"> <a role="menuitem" lang="ko" >한국어</a> </li> </ul> </devsite-language-selector> </nav> </div> </devsite-footer-utility> <devsite-panel></devsite-panel> <devsite-concierge data-info-panel data-ai-panel data-api-explorer-panel > </devsite-concierge> </section></section> <devsite-sitemask></devsite-sitemask> <devsite-snackbar></devsite-snackbar> <devsite-tooltip ></devsite-tooltip> <devsite-heading-link></devsite-heading-link> <devsite-analytics> <script type="application/json" analytics>[{"dimensions": {"dimension5": "en", "dimension6": "en", "dimension11": false, "dimension4": "People API", "dimension3": false, "dimension1": "Signed out"}, "gaid": "UA-24532603-1", "metrics": {"ratings_value": "metric1", "ratings_count": "metric2"}, "purpose": 1}]</script> <script type="application/json" tag-management>{"at": "True", "ga4": [{"id": "G-272J68FCRF", "purpose": 1}, {"id": "G-YYP88VSJWR", "purpose": 0}], "ga4p": [{"id": "G-272J68FCRF", "purpose": 1}], "gtm": [], "parameters": {"internalUser": "False", "language": {"machineTranslated": "False", "requested": "en", "served": "en"}, "pageType": "reference", "projectName": "People API", "signedIn": "False", "tenant": "developers", "recommendations": {"sourcePage": "", "sourceType": 0, "sourceRank": 0, "sourceIdenticalDescriptions": 0, "sourceTitleWords": 0, "sourceDescriptionWords": 0, "experiment": ""}, "experiment": {"ids": ""}}}</script> </devsite-analytics> <devsite-badger></devsite-badger> <script nonce="wR9Hlein4HaFg5a1kwCHlXJxUke2hD"> (function(d,e,v,s,i,t,E){d['GoogleDevelopersObject']=i; t=e.createElement(v);t.async=1;t.src=s;E=e.getElementsByTagName(v)[0]; E.parentNode.insertBefore(t,E);})(window, document, 'script', 'https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/js/app_loader.js', '[1,"en",null,"/js/devsite_app_module.js","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers","https://developers-dot-devsite-v2-prod.appspot.com",null,null,["/_pwa/developers/manifest.json","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/images/video-placeholder.svg","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/favicon-new.png","https://fonts.googleapis.com/css?family=Google+Sans:400,500|Roboto:400,400italic,500,500italic,700,700italic|Roboto+Mono:400,500,700&display=swap"],1,null,[1,6,8,12,14,17,21,25,50,52,63,70,75,76,80,87,91,92,93,97,98,100,101,102,103,104,105,107,108,109,110,112,113,117,118,120,122,124,125,126,127,129,130,131,132,133,134,135,136,138,140,141,147,148,149,151,152,156,157,158,159,161,163,164,168,169,170,179,180,182,183,186,191,193,196],"AIzaSyAP-jjEJBzmIyKR4F-3XITp8yM9T1gEEI8","AIzaSyB6xiKGDR5O3Ak2okS4rLkauxGUG7XP0hg","developers.google.com","AIzaSyAQk0fBONSGUqCNznf6Krs82Ap1-NV6J4o","AIzaSyCCxcqdrZ_7QMeLCRY20bh_SXdAYqy70KY",null,null,null,["MiscFeatureFlags__emergency_css","Significatio__enable_by_tenant","Concierge__enable_pushui","BookNav__enable_tenant_cache_key","Profiles__enable_page_saving","Cloud__enable_cloud_shell_fte_user_flow","Profiles__enable_completecodelab_endpoint","MiscFeatureFlags__developers_footer_image","TpcFeatures__enable_required_headers","Profiles__enable_profile_collections","MiscFeatureFlags__enable_project_variables","Cloud__enable_cloudx_experiment_ids","MiscFeatureFlags__developers_footer_dark_image","DevPro__enable_cloud_innovators_plus","MiscFeatureFlags__enable_view_transitions","Cloud__enable_llm_concierge_chat","Cloud__enable_cloud_facet_chat","Search__enable_page_map","CloudShell__cloud_shell_button","Profiles__require_profile_eligibility_for_signin","Profiles__enable_release_notes_notifications","Search__enable_suggestions_from_borg","MiscFeatureFlags__enable_explain_this_code","Cloud__enable_free_trial_server_call","Analytics__enable_clearcut_logging","Cloud__enable_cloudx_ping","Concierge__enable_concierge_restricted","Cloud__enable_cloud_dlp_service","Cloud__enable_cloud_shell","Cloud__enable_legacy_calculator_redirect","Profiles__enable_developer_profiles_callout","Search__enable_ai_search_summaries_restricted","Search__enable_ai_search_summaries","Concierge__enable_concierge","Profiles__enable_awarding_url","MiscFeatureFlags__enable_firebase_utm","Profiles__enable_public_developer_profiles","Search__enable_ai_eligibility_checks","Experiments__reqs_query_experiments","CloudShell__cloud_code_overflow_menu","Search__enable_dynamic_content_confidential_banner","Profiles__enable_recognition_badges","MiscFeatureFlags__enable_variable_operator","Profiles__enable_dashboard_curated_recommendations","DevPro__enable_developer_subscriptions","TpcFeatures__enable_mirror_tenant_redirects","EngEduTelemetry__enable_engedu_telemetry","Profiles__enable_complete_playlist_endpoint"],null,null,"AIzaSyBLEMok-5suZ67qRPzx0qUtbnLmyT_kCVE","https://developerscontentserving-pa.clients6.google.com","AIzaSyCM4QpTRSqP5qI4Dvjt4OAScIN8sOUlO-k","https://developerscontentsearch-pa.clients6.google.com",1,4,null,"https://developerprofiles-pa.clients6.google.com",[1,"developers","Google for Developers","developers.google.com",null,"developers-dot-devsite-v2-prod.appspot.com",null,null,[1,1,[1],null,null,null,null,null,null,null,null,[1],null,null,null,null,null,null,[1],[1,null,null,[1,20],"/recommendations/information"],null,null,null,[1,1,1],[1,1,null,1,1]],null,[null,null,null,null,null,null,"/images/lockup-new.svg","/images/touchicon-180-new.png",null,null,null,null,1,null,null,null,null,null,null,null,null,1,null,null,null,"/images/lockup-dark-theme-new.svg",[]],[],null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,[6,1,14,15,20,22,23,29,32,36],null,[[null,null,null,[3,7,10,2,39,17,4,32,24,11,12,13,34,15,25],null,null,[1,[["docType","Choose a content type",[["Tutorial",null,null,null,null,null,null,null,null,"Tutorial"],["Guide",null,null,null,null,null,null,null,null,"Guide"],["Sample",null,null,null,null,null,null,null,null,"Sample"]]],["product","Choose a product",[["Android",null,null,null,null,null,null,null,null,"Android"],["ARCore",null,null,null,null,null,null,null,null,"ARCore"],["ChromeOS",null,null,null,null,null,null,null,null,"ChromeOS"],["Firebase",null,null,null,null,null,null,null,null,"Firebase"],["Flutter",null,null,null,null,null,null,null,null,"Flutter"],["Assistant",null,null,null,null,null,null,null,null,"Google Assistant"],["GoogleCloud",null,null,null,null,null,null,null,null,"Google Cloud"],["GoogleMapsPlatform",null,null,null,null,null,null,null,null,"Google Maps Platform"],["GooglePay",null,null,null,null,null,null,null,null,"Google Pay & Google Wallet"],["GooglePlay",null,null,null,null,null,null,null,null,"Google Play"],["Tensorflow",null,null,null,null,null,null,null,null,"TensorFlow"]]],["category","Choose a topic",[["AiAndMachineLearning",null,null,null,null,null,null,null,null,"AI and Machine Learning"],["Data",null,null,null,null,null,null,null,null,"Data"],["Enterprise",null,null,null,null,null,null,null,null,"Enterprise"],["Gaming",null,null,null,null,null,null,null,null,"Gaming"],["Mobile",null,null,null,null,null,null,null,null,"Mobile"],["Web",null,null,null,null,null,null,null,null,"Web"]]]]]],[1,1],null,1],[[["UA-24532603-1"],["UA-22084204-5"],null,null,["UA-24532603-5"],null,null,[["G-272J68FCRF"],null,null,[["G-272J68FCRF",2]]],[["UA-24532603-1",2]],null,[["UA-24532603-5",2]],null,1],[[5,4],[3,2],[16,13],[4,3],[11,8],[6,5],[15,12],[14,11],[1,1],[13,10],[12,9]],[[2,2],[1,1]]],null,4,null,null,null,null,null,null,null,null,null,null,null,null,null,"developers.devsite.google"],null,"pk_live_5170syrHvgGVmSx9sBrnWtA5luvk9BwnVcvIi7HizpwauFG96WedXsuXh790rtij9AmGllqPtMLfhe2RSwD6Pn38V00uBCydV4m"]') </script> <devsite-a11y-announce></devsite-a11y-announce> </body> </html>