1<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5  margin: 0;
6  padding: 0;
7  border: 0;
8  font-weight: inherit;
9  font-style: inherit;
10  font-size: 100%;
11  font-family: inherit;
12  vertical-align: baseline;
13}
14
15body {
16  font-size: 13px;
17  padding: 1em;
18}
19
20h1 {
21  font-size: 26px;
22  margin-bottom: 1em;
23}
24
25h2 {
26  font-size: 24px;
27  margin-bottom: 1em;
28}
29
30h3 {
31  font-size: 20px;
32  margin-bottom: 1em;
33  margin-top: 1em;
34}
35
36pre, code {
37  line-height: 1.5;
38  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42  margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46  font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50  border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54  margin-top: 0.5em;
55}
56
57.firstline {
58  margin-left: 2 em;
59}
60
61.method  {
62  margin-top: 1em;
63  border: solid 1px #CCC;
64  padding: 1em;
65  background: #EEE;
66}
67
68.details {
69  font-weight: bold;
70  font-size: 14px;
71}
72
73</style>
74
75<h1><a href="plusDomains_v1.html">Google+ Domains API</a> . <a href="plusDomains_v1.people.html">people</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78  <code><a href="#get">get(userId)</a></code></p>
79<p class="firstline">Get a person's profile.</p>
80<p class="toc_element">
81  <code><a href="#list">list(userId, collection, orderBy=None, pageToken=None, maxResults=None)</a></code></p>
82<p class="firstline">List all of the people in the specified collection.</p>
83<p class="toc_element">
84  <code><a href="#listByActivity">listByActivity(activityId, collection, pageToken=None, maxResults=None)</a></code></p>
85<p class="firstline">List all of the people in the specified collection for a particular activity.</p>
86<p class="toc_element">
87  <code><a href="#listByActivity_next">listByActivity_next(previous_request, previous_response)</a></code></p>
88<p class="firstline">Retrieves the next page of results.</p>
89<p class="toc_element">
90  <code><a href="#listByCircle">listByCircle(circleId, pageToken=None, maxResults=None)</a></code></p>
91<p class="firstline">List all of the people who are members of a circle.</p>
92<p class="toc_element">
93  <code><a href="#listByCircle_next">listByCircle_next(previous_request, previous_response)</a></code></p>
94<p class="firstline">Retrieves the next page of results.</p>
95<p class="toc_element">
96  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
97<p class="firstline">Retrieves the next page of results.</p>
98<h3>Method Details</h3>
99<div class="method">
100    <code class="details" id="get">get(userId)</code>
101  <pre>Get a person's profile.
102
103Args:
104  userId: string, The ID of the person to get the profile for. The special value "me" can be used to indicate the authenticated user. (required)
105
106Returns:
107  An object of the form:
108
109    {
110    "braggingRights": "A String", # The "bragging rights" line of this person.
111    "image": { # The representation of the person's profile photo.
112      "url": "A String", # The URL of the person's profile photo. To resize the image and crop it to a square, append the query string ?sz=x, where x is the dimension in pixels of each side.
113      "isDefault": True or False, # Whether the person's profile photo is the default one
114    },
115    "domain": "A String", # The hosted domain name for the user's Google Apps account. For instance, example.com. The plus.profile.emails.read or email scope is needed to get this domain name.
116    "id": "A String", # The ID of this person.
117    "occupation": "A String", # The occupation of this person.
118    "verified": True or False, # Whether the person or Google+ Page has been verified.
119    "tagline": "A String", # The brief description (tagline) of this person.
120    "currentLocation": "A String", # (this field is not currently used)
121    "etag": "A String", # ETag of this response for caching purposes.
122    "circledByCount": 42, # For followers who are visible, the number of people who have added this person or page to a circle.
123    "objectType": "A String", # Type of person within Google+. Possible values include, but are not limited to, the following values:
124        # - "person" - represents an actual person.
125        # - "page" - represents a page.
126    "relationshipStatus": "A String", # The person's relationship status. Possible values include, but are not limited to, the following values:
127        # - "single" - Person is single.
128        # - "in_a_relationship" - Person is in a relationship.
129        # - "engaged" - Person is engaged.
130        # - "married" - Person is married.
131        # - "its_complicated" - The relationship is complicated.
132        # - "open_relationship" - Person is in an open relationship.
133        # - "widowed" - Person is widowed.
134        # - "in_domestic_partnership" - Person is in a domestic partnership.
135        # - "in_civil_union" - Person is in a civil union.
136    "aboutMe": "A String", # A short biography for this person.
137    "placesLived": [ # A list of places where this person has lived.
138      {
139        "primary": True or False, # If "true", this place of residence is this person's primary residence.
140        "value": "A String", # A place where this person has lived. For example: "Seattle, WA", "Near Toronto".
141      },
142    ],
143    "birthday": "A String", # The person's date of birth, represented as YYYY-MM-DD.
144    "nickname": "A String", # The nickname of this person.
145    "emails": [ # A list of email addresses that this person has, including their Google account email address, and the public verified email addresses on their Google+ profile. The plus.profile.emails.read scope is needed to retrieve these email addresses, or the email scope can be used to retrieve just the Google account email address.
146      {
147        "type": "A String", # The type of address. Possible values include, but are not limited to, the following values:
148            # - "account" - Google account email address.
149            # - "home" - Home email address.
150            # - "work" - Work email address.
151            # - "other" - Other.
152        "value": "A String", # The email address.
153      },
154    ],
155    "organizations": [ # A list of current or past organizations with which this person is associated.
156      {
157        "startDate": "A String", # The date that the person joined this organization.
158        "endDate": "A String", # The date that the person left this organization.
159        "description": "A String", # A short description of the person's role in this organization. Deprecated.
160        "title": "A String", # The person's job title or role within the organization.
161        "primary": True or False, # If "true", indicates this organization is the person's primary one, which is typically interpreted as the current one.
162        "location": "A String", # The location of this organization. Deprecated.
163        "department": "A String", # The department within the organization. Deprecated.
164        "type": "A String", # The type of organization. Possible values include, but are not limited to, the following values:
165            # - "work" - Work.
166            # - "school" - School.
167        "name": "A String", # The name of the organization.
168      },
169    ],
170    "kind": "plus#person", # Identifies this resource as a person. Value: "plus#person".
171    "displayName": "A String", # The name of this person, which is suitable for display.
172    "name": { # An object representation of the individual components of a person's name.
173      "honorificPrefix": "A String", # The honorific prefixes (such as "Dr." or "Mrs.") for this person.
174      "middleName": "A String", # The middle name of this person.
175      "familyName": "A String", # The family name (last name) of this person.
176      "formatted": "A String", # The full name of this person, including middle names, suffixes, etc.
177      "givenName": "A String", # The given name (first name) of this person.
178      "honorificSuffix": "A String", # The honorific suffixes (such as "Jr.") for this person.
179    },
180    "skills": "A String", # The person's skills.
181    "gender": "A String", # The person's gender. Possible values include, but are not limited to, the following values:
182        # - "male" - Male gender.
183        # - "female" - Female gender.
184        # - "other" - Other.
185    "cover": { # The cover photo content.
186      "layout": "A String", # The layout of the cover art. Possible values include, but are not limited to, the following values:
187          # - "banner" - One large image banner.
188      "coverInfo": { # Extra information about the cover photo.
189        "leftImageOffset": 42, # The difference between the left position of the cover image and the actual displayed cover image. Only valid for banner layout.
190        "topImageOffset": 42, # The difference between the top position of the cover image and the actual displayed cover image. Only valid for banner layout.
191      },
192      "coverPhoto": { # The person's primary cover image.
193        "url": "A String", # The URL of the image.
194        "width": 42, # The width of the image.
195        "height": 42, # The height of the image.
196      },
197    },
198    "url": "A String", # The URL of this person's profile.
199    "isPlusUser": True or False, # Whether this user has signed up for Google+.
200    "plusOneCount": 42, # If a Google+ Page, the number of people who have +1'd this page.
201    "urls": [ # A list of URLs for this person.
202      {
203        "type": "A String", # The type of URL. Possible values include, but are not limited to, the following values:
204            # - "otherProfile" - URL for another profile.
205            # - "contributor" - URL to a site for which this person is a contributor.
206            # - "website" - URL for this Google+ Page's primary website.
207            # - "other" - Other URL.
208        "value": "A String", # The URL value.
209        "label": "A String", # The label of the URL.
210      },
211    ],
212  }</pre>
213</div>
214
215<div class="method">
216    <code class="details" id="list">list(userId, collection, orderBy=None, pageToken=None, maxResults=None)</code>
217  <pre>List all of the people in the specified collection.
218
219Args:
220  userId: string, Get the collection of people for the person identified. Use "me" to indicate the authenticated user. (required)
221  collection: string, The collection of people to list. (required)
222    Allowed values
223      circled - The list of people who this user has added to one or more circles.
224  orderBy: string, The order to return people in.
225    Allowed values
226      alphabetical - Order the people by their display name.
227      best - Order people based on the relevence to the viewer.
228  pageToken: string, The continuation token, which is used to page through large result sets. To get the next page of results, set this parameter to the value of "nextPageToken" from the previous response.
229  maxResults: integer, The maximum number of people to include in the response, which is used for paging. For any response, the actual number returned might be less than the specified maxResults.
230
231Returns:
232  An object of the form:
233
234    {
235    "nextPageToken": "A String", # The continuation token, which is used to page through large result sets. Provide this value in a subsequent request to return the next page of results.
236    "kind": "plus#peopleFeed", # Identifies this resource as a collection of people. Value: "plus#peopleFeed".
237    "title": "A String", # The title of this collection of people.
238    "items": [ # The people in this page of results. Each item includes the id, displayName, image, and url for the person. To retrieve additional profile data, see the people.get method.
239      {
240        "braggingRights": "A String", # The "bragging rights" line of this person.
241        "image": { # The representation of the person's profile photo.
242          "url": "A String", # The URL of the person's profile photo. To resize the image and crop it to a square, append the query string ?sz=x, where x is the dimension in pixels of each side.
243          "isDefault": True or False, # Whether the person's profile photo is the default one
244        },
245        "domain": "A String", # The hosted domain name for the user's Google Apps account. For instance, example.com. The plus.profile.emails.read or email scope is needed to get this domain name.
246        "id": "A String", # The ID of this person.
247        "occupation": "A String", # The occupation of this person.
248        "verified": True or False, # Whether the person or Google+ Page has been verified.
249        "tagline": "A String", # The brief description (tagline) of this person.
250        "currentLocation": "A String", # (this field is not currently used)
251        "etag": "A String", # ETag of this response for caching purposes.
252        "circledByCount": 42, # For followers who are visible, the number of people who have added this person or page to a circle.
253        "objectType": "A String", # Type of person within Google+. Possible values include, but are not limited to, the following values:
254            # - "person" - represents an actual person.
255            # - "page" - represents a page.
256        "relationshipStatus": "A String", # The person's relationship status. Possible values include, but are not limited to, the following values:
257            # - "single" - Person is single.
258            # - "in_a_relationship" - Person is in a relationship.
259            # - "engaged" - Person is engaged.
260            # - "married" - Person is married.
261            # - "its_complicated" - The relationship is complicated.
262            # - "open_relationship" - Person is in an open relationship.
263            # - "widowed" - Person is widowed.
264            # - "in_domestic_partnership" - Person is in a domestic partnership.
265            # - "in_civil_union" - Person is in a civil union.
266        "aboutMe": "A String", # A short biography for this person.
267        "placesLived": [ # A list of places where this person has lived.
268          {
269            "primary": True or False, # If "true", this place of residence is this person's primary residence.
270            "value": "A String", # A place where this person has lived. For example: "Seattle, WA", "Near Toronto".
271          },
272        ],
273        "birthday": "A String", # The person's date of birth, represented as YYYY-MM-DD.
274        "nickname": "A String", # The nickname of this person.
275        "emails": [ # A list of email addresses that this person has, including their Google account email address, and the public verified email addresses on their Google+ profile. The plus.profile.emails.read scope is needed to retrieve these email addresses, or the email scope can be used to retrieve just the Google account email address.
276          {
277            "type": "A String", # The type of address. Possible values include, but are not limited to, the following values:
278                # - "account" - Google account email address.
279                # - "home" - Home email address.
280                # - "work" - Work email address.
281                # - "other" - Other.
282            "value": "A String", # The email address.
283          },
284        ],
285        "organizations": [ # A list of current or past organizations with which this person is associated.
286          {
287            "startDate": "A String", # The date that the person joined this organization.
288            "endDate": "A String", # The date that the person left this organization.
289            "description": "A String", # A short description of the person's role in this organization. Deprecated.
290            "title": "A String", # The person's job title or role within the organization.
291            "primary": True or False, # If "true", indicates this organization is the person's primary one, which is typically interpreted as the current one.
292            "location": "A String", # The location of this organization. Deprecated.
293            "department": "A String", # The department within the organization. Deprecated.
294            "type": "A String", # The type of organization. Possible values include, but are not limited to, the following values:
295                # - "work" - Work.
296                # - "school" - School.
297            "name": "A String", # The name of the organization.
298          },
299        ],
300        "kind": "plus#person", # Identifies this resource as a person. Value: "plus#person".
301        "displayName": "A String", # The name of this person, which is suitable for display.
302        "name": { # An object representation of the individual components of a person's name.
303          "honorificPrefix": "A String", # The honorific prefixes (such as "Dr." or "Mrs.") for this person.
304          "middleName": "A String", # The middle name of this person.
305          "familyName": "A String", # The family name (last name) of this person.
306          "formatted": "A String", # The full name of this person, including middle names, suffixes, etc.
307          "givenName": "A String", # The given name (first name) of this person.
308          "honorificSuffix": "A String", # The honorific suffixes (such as "Jr.") for this person.
309        },
310        "skills": "A String", # The person's skills.
311        "gender": "A String", # The person's gender. Possible values include, but are not limited to, the following values:
312            # - "male" - Male gender.
313            # - "female" - Female gender.
314            # - "other" - Other.
315        "cover": { # The cover photo content.
316          "layout": "A String", # The layout of the cover art. Possible values include, but are not limited to, the following values:
317              # - "banner" - One large image banner.
318          "coverInfo": { # Extra information about the cover photo.
319            "leftImageOffset": 42, # The difference between the left position of the cover image and the actual displayed cover image. Only valid for banner layout.
320            "topImageOffset": 42, # The difference between the top position of the cover image and the actual displayed cover image. Only valid for banner layout.
321          },
322          "coverPhoto": { # The person's primary cover image.
323            "url": "A String", # The URL of the image.
324            "width": 42, # The width of the image.
325            "height": 42, # The height of the image.
326          },
327        },
328        "url": "A String", # The URL of this person's profile.
329        "isPlusUser": True or False, # Whether this user has signed up for Google+.
330        "plusOneCount": 42, # If a Google+ Page, the number of people who have +1'd this page.
331        "urls": [ # A list of URLs for this person.
332          {
333            "type": "A String", # The type of URL. Possible values include, but are not limited to, the following values:
334                # - "otherProfile" - URL for another profile.
335                # - "contributor" - URL to a site for which this person is a contributor.
336                # - "website" - URL for this Google+ Page's primary website.
337                # - "other" - Other URL.
338            "value": "A String", # The URL value.
339            "label": "A String", # The label of the URL.
340          },
341        ],
342      },
343    ],
344    "etag": "A String", # ETag of this response for caching purposes.
345    "totalItems": 42, # The total number of people available in this list. The number of people in a response might be smaller due to paging. This might not be set for all collections.
346    "selfLink": "A String", # Link to this resource.
347  }</pre>
348</div>
349
350<div class="method">
351    <code class="details" id="listByActivity">listByActivity(activityId, collection, pageToken=None, maxResults=None)</code>
352  <pre>List all of the people in the specified collection for a particular activity.
353
354Args:
355  activityId: string, The ID of the activity to get the list of people for. (required)
356  collection: string, The collection of people to list. (required)
357    Allowed values
358      plusoners - List all people who have +1'd this activity.
359      resharers - List all people who have reshared this activity.
360      sharedto - List all people who this activity was shared to.
361  pageToken: string, The continuation token, which is used to page through large result sets. To get the next page of results, set this parameter to the value of "nextPageToken" from the previous response.
362  maxResults: integer, The maximum number of people to include in the response, which is used for paging. For any response, the actual number returned might be less than the specified maxResults.
363
364Returns:
365  An object of the form:
366
367    {
368    "nextPageToken": "A String", # The continuation token, which is used to page through large result sets. Provide this value in a subsequent request to return the next page of results.
369    "kind": "plus#peopleFeed", # Identifies this resource as a collection of people. Value: "plus#peopleFeed".
370    "title": "A String", # The title of this collection of people.
371    "items": [ # The people in this page of results. Each item includes the id, displayName, image, and url for the person. To retrieve additional profile data, see the people.get method.
372      {
373        "braggingRights": "A String", # The "bragging rights" line of this person.
374        "image": { # The representation of the person's profile photo.
375          "url": "A String", # The URL of the person's profile photo. To resize the image and crop it to a square, append the query string ?sz=x, where x is the dimension in pixels of each side.
376          "isDefault": True or False, # Whether the person's profile photo is the default one
377        },
378        "domain": "A String", # The hosted domain name for the user's Google Apps account. For instance, example.com. The plus.profile.emails.read or email scope is needed to get this domain name.
379        "id": "A String", # The ID of this person.
380        "occupation": "A String", # The occupation of this person.
381        "verified": True or False, # Whether the person or Google+ Page has been verified.
382        "tagline": "A String", # The brief description (tagline) of this person.
383        "currentLocation": "A String", # (this field is not currently used)
384        "etag": "A String", # ETag of this response for caching purposes.
385        "circledByCount": 42, # For followers who are visible, the number of people who have added this person or page to a circle.
386        "objectType": "A String", # Type of person within Google+. Possible values include, but are not limited to, the following values:
387            # - "person" - represents an actual person.
388            # - "page" - represents a page.
389        "relationshipStatus": "A String", # The person's relationship status. Possible values include, but are not limited to, the following values:
390            # - "single" - Person is single.
391            # - "in_a_relationship" - Person is in a relationship.
392            # - "engaged" - Person is engaged.
393            # - "married" - Person is married.
394            # - "its_complicated" - The relationship is complicated.
395            # - "open_relationship" - Person is in an open relationship.
396            # - "widowed" - Person is widowed.
397            # - "in_domestic_partnership" - Person is in a domestic partnership.
398            # - "in_civil_union" - Person is in a civil union.
399        "aboutMe": "A String", # A short biography for this person.
400        "placesLived": [ # A list of places where this person has lived.
401          {
402            "primary": True or False, # If "true", this place of residence is this person's primary residence.
403            "value": "A String", # A place where this person has lived. For example: "Seattle, WA", "Near Toronto".
404          },
405        ],
406        "birthday": "A String", # The person's date of birth, represented as YYYY-MM-DD.
407        "nickname": "A String", # The nickname of this person.
408        "emails": [ # A list of email addresses that this person has, including their Google account email address, and the public verified email addresses on their Google+ profile. The plus.profile.emails.read scope is needed to retrieve these email addresses, or the email scope can be used to retrieve just the Google account email address.
409          {
410            "type": "A String", # The type of address. Possible values include, but are not limited to, the following values:
411                # - "account" - Google account email address.
412                # - "home" - Home email address.
413                # - "work" - Work email address.
414                # - "other" - Other.
415            "value": "A String", # The email address.
416          },
417        ],
418        "organizations": [ # A list of current or past organizations with which this person is associated.
419          {
420            "startDate": "A String", # The date that the person joined this organization.
421            "endDate": "A String", # The date that the person left this organization.
422            "description": "A String", # A short description of the person's role in this organization. Deprecated.
423            "title": "A String", # The person's job title or role within the organization.
424            "primary": True or False, # If "true", indicates this organization is the person's primary one, which is typically interpreted as the current one.
425            "location": "A String", # The location of this organization. Deprecated.
426            "department": "A String", # The department within the organization. Deprecated.
427            "type": "A String", # The type of organization. Possible values include, but are not limited to, the following values:
428                # - "work" - Work.
429                # - "school" - School.
430            "name": "A String", # The name of the organization.
431          },
432        ],
433        "kind": "plus#person", # Identifies this resource as a person. Value: "plus#person".
434        "displayName": "A String", # The name of this person, which is suitable for display.
435        "name": { # An object representation of the individual components of a person's name.
436          "honorificPrefix": "A String", # The honorific prefixes (such as "Dr." or "Mrs.") for this person.
437          "middleName": "A String", # The middle name of this person.
438          "familyName": "A String", # The family name (last name) of this person.
439          "formatted": "A String", # The full name of this person, including middle names, suffixes, etc.
440          "givenName": "A String", # The given name (first name) of this person.
441          "honorificSuffix": "A String", # The honorific suffixes (such as "Jr.") for this person.
442        },
443        "skills": "A String", # The person's skills.
444        "gender": "A String", # The person's gender. Possible values include, but are not limited to, the following values:
445            # - "male" - Male gender.
446            # - "female" - Female gender.
447            # - "other" - Other.
448        "cover": { # The cover photo content.
449          "layout": "A String", # The layout of the cover art. Possible values include, but are not limited to, the following values:
450              # - "banner" - One large image banner.
451          "coverInfo": { # Extra information about the cover photo.
452            "leftImageOffset": 42, # The difference between the left position of the cover image and the actual displayed cover image. Only valid for banner layout.
453            "topImageOffset": 42, # The difference between the top position of the cover image and the actual displayed cover image. Only valid for banner layout.
454          },
455          "coverPhoto": { # The person's primary cover image.
456            "url": "A String", # The URL of the image.
457            "width": 42, # The width of the image.
458            "height": 42, # The height of the image.
459          },
460        },
461        "url": "A String", # The URL of this person's profile.
462        "isPlusUser": True or False, # Whether this user has signed up for Google+.
463        "plusOneCount": 42, # If a Google+ Page, the number of people who have +1'd this page.
464        "urls": [ # A list of URLs for this person.
465          {
466            "type": "A String", # The type of URL. Possible values include, but are not limited to, the following values:
467                # - "otherProfile" - URL for another profile.
468                # - "contributor" - URL to a site for which this person is a contributor.
469                # - "website" - URL for this Google+ Page's primary website.
470                # - "other" - Other URL.
471            "value": "A String", # The URL value.
472            "label": "A String", # The label of the URL.
473          },
474        ],
475      },
476    ],
477    "etag": "A String", # ETag of this response for caching purposes.
478    "totalItems": 42, # The total number of people available in this list. The number of people in a response might be smaller due to paging. This might not be set for all collections.
479    "selfLink": "A String", # Link to this resource.
480  }</pre>
481</div>
482
483<div class="method">
484    <code class="details" id="listByActivity_next">listByActivity_next(previous_request, previous_response)</code>
485  <pre>Retrieves the next page of results.
486
487Args:
488  previous_request: The request for the previous page. (required)
489  previous_response: The response from the request for the previous page. (required)
490
491Returns:
492  A request object that you can call 'execute()' on to request the next
493  page. Returns None if there are no more items in the collection.
494    </pre>
495</div>
496
497<div class="method">
498    <code class="details" id="listByCircle">listByCircle(circleId, pageToken=None, maxResults=None)</code>
499  <pre>List all of the people who are members of a circle.
500
501Args:
502  circleId: string, The ID of the circle to get the members of. (required)
503  pageToken: string, The continuation token, which is used to page through large result sets. To get the next page of results, set this parameter to the value of "nextPageToken" from the previous response.
504  maxResults: integer, The maximum number of people to include in the response, which is used for paging. For any response, the actual number returned might be less than the specified maxResults.
505
506Returns:
507  An object of the form:
508
509    {
510    "nextPageToken": "A String", # The continuation token, which is used to page through large result sets. Provide this value in a subsequent request to return the next page of results.
511    "kind": "plus#peopleFeed", # Identifies this resource as a collection of people. Value: "plus#peopleFeed".
512    "title": "A String", # The title of this collection of people.
513    "items": [ # The people in this page of results. Each item includes the id, displayName, image, and url for the person. To retrieve additional profile data, see the people.get method.
514      {
515        "braggingRights": "A String", # The "bragging rights" line of this person.
516        "image": { # The representation of the person's profile photo.
517          "url": "A String", # The URL of the person's profile photo. To resize the image and crop it to a square, append the query string ?sz=x, where x is the dimension in pixels of each side.
518          "isDefault": True or False, # Whether the person's profile photo is the default one
519        },
520        "domain": "A String", # The hosted domain name for the user's Google Apps account. For instance, example.com. The plus.profile.emails.read or email scope is needed to get this domain name.
521        "id": "A String", # The ID of this person.
522        "occupation": "A String", # The occupation of this person.
523        "verified": True or False, # Whether the person or Google+ Page has been verified.
524        "tagline": "A String", # The brief description (tagline) of this person.
525        "currentLocation": "A String", # (this field is not currently used)
526        "etag": "A String", # ETag of this response for caching purposes.
527        "circledByCount": 42, # For followers who are visible, the number of people who have added this person or page to a circle.
528        "objectType": "A String", # Type of person within Google+. Possible values include, but are not limited to, the following values:
529            # - "person" - represents an actual person.
530            # - "page" - represents a page.
531        "relationshipStatus": "A String", # The person's relationship status. Possible values include, but are not limited to, the following values:
532            # - "single" - Person is single.
533            # - "in_a_relationship" - Person is in a relationship.
534            # - "engaged" - Person is engaged.
535            # - "married" - Person is married.
536            # - "its_complicated" - The relationship is complicated.
537            # - "open_relationship" - Person is in an open relationship.
538            # - "widowed" - Person is widowed.
539            # - "in_domestic_partnership" - Person is in a domestic partnership.
540            # - "in_civil_union" - Person is in a civil union.
541        "aboutMe": "A String", # A short biography for this person.
542        "placesLived": [ # A list of places where this person has lived.
543          {
544            "primary": True or False, # If "true", this place of residence is this person's primary residence.
545            "value": "A String", # A place where this person has lived. For example: "Seattle, WA", "Near Toronto".
546          },
547        ],
548        "birthday": "A String", # The person's date of birth, represented as YYYY-MM-DD.
549        "nickname": "A String", # The nickname of this person.
550        "emails": [ # A list of email addresses that this person has, including their Google account email address, and the public verified email addresses on their Google+ profile. The plus.profile.emails.read scope is needed to retrieve these email addresses, or the email scope can be used to retrieve just the Google account email address.
551          {
552            "type": "A String", # The type of address. Possible values include, but are not limited to, the following values:
553                # - "account" - Google account email address.
554                # - "home" - Home email address.
555                # - "work" - Work email address.
556                # - "other" - Other.
557            "value": "A String", # The email address.
558          },
559        ],
560        "organizations": [ # A list of current or past organizations with which this person is associated.
561          {
562            "startDate": "A String", # The date that the person joined this organization.
563            "endDate": "A String", # The date that the person left this organization.
564            "description": "A String", # A short description of the person's role in this organization. Deprecated.
565            "title": "A String", # The person's job title or role within the organization.
566            "primary": True or False, # If "true", indicates this organization is the person's primary one, which is typically interpreted as the current one.
567            "location": "A String", # The location of this organization. Deprecated.
568            "department": "A String", # The department within the organization. Deprecated.
569            "type": "A String", # The type of organization. Possible values include, but are not limited to, the following values:
570                # - "work" - Work.
571                # - "school" - School.
572            "name": "A String", # The name of the organization.
573          },
574        ],
575        "kind": "plus#person", # Identifies this resource as a person. Value: "plus#person".
576        "displayName": "A String", # The name of this person, which is suitable for display.
577        "name": { # An object representation of the individual components of a person's name.
578          "honorificPrefix": "A String", # The honorific prefixes (such as "Dr." or "Mrs.") for this person.
579          "middleName": "A String", # The middle name of this person.
580          "familyName": "A String", # The family name (last name) of this person.
581          "formatted": "A String", # The full name of this person, including middle names, suffixes, etc.
582          "givenName": "A String", # The given name (first name) of this person.
583          "honorificSuffix": "A String", # The honorific suffixes (such as "Jr.") for this person.
584        },
585        "skills": "A String", # The person's skills.
586        "gender": "A String", # The person's gender. Possible values include, but are not limited to, the following values:
587            # - "male" - Male gender.
588            # - "female" - Female gender.
589            # - "other" - Other.
590        "cover": { # The cover photo content.
591          "layout": "A String", # The layout of the cover art. Possible values include, but are not limited to, the following values:
592              # - "banner" - One large image banner.
593          "coverInfo": { # Extra information about the cover photo.
594            "leftImageOffset": 42, # The difference between the left position of the cover image and the actual displayed cover image. Only valid for banner layout.
595            "topImageOffset": 42, # The difference between the top position of the cover image and the actual displayed cover image. Only valid for banner layout.
596          },
597          "coverPhoto": { # The person's primary cover image.
598            "url": "A String", # The URL of the image.
599            "width": 42, # The width of the image.
600            "height": 42, # The height of the image.
601          },
602        },
603        "url": "A String", # The URL of this person's profile.
604        "isPlusUser": True or False, # Whether this user has signed up for Google+.
605        "plusOneCount": 42, # If a Google+ Page, the number of people who have +1'd this page.
606        "urls": [ # A list of URLs for this person.
607          {
608            "type": "A String", # The type of URL. Possible values include, but are not limited to, the following values:
609                # - "otherProfile" - URL for another profile.
610                # - "contributor" - URL to a site for which this person is a contributor.
611                # - "website" - URL for this Google+ Page's primary website.
612                # - "other" - Other URL.
613            "value": "A String", # The URL value.
614            "label": "A String", # The label of the URL.
615          },
616        ],
617      },
618    ],
619    "etag": "A String", # ETag of this response for caching purposes.
620    "totalItems": 42, # The total number of people available in this list. The number of people in a response might be smaller due to paging. This might not be set for all collections.
621    "selfLink": "A String", # Link to this resource.
622  }</pre>
623</div>
624
625<div class="method">
626    <code class="details" id="listByCircle_next">listByCircle_next(previous_request, previous_response)</code>
627  <pre>Retrieves the next page of results.
628
629Args:
630  previous_request: The request for the previous page. (required)
631  previous_response: The response from the request for the previous page. (required)
632
633Returns:
634  A request object that you can call 'execute()' on to request the next
635  page. Returns None if there are no more items in the collection.
636    </pre>
637</div>
638
639<div class="method">
640    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
641  <pre>Retrieves the next page of results.
642
643Args:
644  previous_request: The request for the previous page. (required)
645  previous_response: The response from the request for the previous page. (required)
646
647Returns:
648  A request object that you can call 'execute()' on to request the next
649  page. Returns None if there are no more items in the collection.
650    </pre>
651</div>
652
653</body></html>