grr

Overview Schema Source Related Servers Discussions Admin

people.people.get

Retrieves a person's profile or contact details by resource name, including the authenticated user via people/me, using a required personFields mask to select returned fields.

Instructions

Provides information about a person by specifying a resource name. Use people/me to indicate the authenticated user. The request returns a 400 error if 'personFields' is not specified [HTTP GET]. Returns the requested resource as JSON — request bodies are built from the typed parameters (typed flags win over the params map), or read whole from body_file Siblings over the same resource: batchCreateContacts, batchDeleteContacts, batchUpdateContacts, createContact, deleteContact, deleteContactPhoto, getBatchGet, listDirectoryPeople, searchContacts, searchDirectoryPeople, updateContact, updateContactPhoto.

Input Schema

Name	Required	Description
`query`	No	Extra KEY=VALUE query pairs for endpoints whose parameters Discovery does not describe.
`params`	No	Parameter map merged into the request; typed parameters win.
`dry_run`	No	Return the request that would be sent, without sending it.
`sources`	No
`body_file`	No	Read the request body from this file ('-' for stdin) instead of building one from the parameters.
`personFields`	No	[query parameter] Required. A field mask to restrict which fields on the person are returned. Multiple fields can be specified by separating them with commas. Valid values are: *
`resourceName`	Yes	[URL path segment] Required. The resource name of the person to provide information about. - To get information about the authenticated user, specify `people/me`. - To get informa
`requestMask.includeField`	No	[query parameter] Required. Comma-separated list of person fields to be included in the response. Each path should start with `person.`: for example, `person.names` or `person.ph

Output Schema

Name	Required	Description	Default
`etag`	No
`urls`	No
`names`	No
`events`	No
`photos`	No
`skills`	No
`genders`	No
`locales`	No
`ageRange`	No
`fileAses`	No
`metadata`	No
`taglines`	No
`addresses`	No
`ageRanges`	No
`birthdays`	No
`imClients`	No
`interests`	No
`locations`	No
`nicknames`	No
`relations`	No
`clientData`	No
`residences`	No
`biographies`	No
`coverPhotos`	No
`externalIds`	No
`memberships`	No
`occupations`	No
`userDefined`	No
`calendarUrls`	No
`miscKeywords`	No
`phoneNumbers`	No
`resourceName`	No
`sipAddresses`	No
`organizations`	No
`braggingRights`	No
`emailAddresses`	No
`relationshipStatuses`	No
`relationshipInterests`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed8 schema fields changedOct 26, 2026

changedInput schema / properties / personFields / description

Previous value: -"Required. A field mask to restrict which fields on the person are returned. Multiple fields can be specified by separating them with commas. Valid values are: *"New value: +"[query parameter] Required. A field mask to restrict which fields on the person are returned. Multiple fields can be specified by separating them with commas. Valid values are: *"

addedInput schema / properties / personFields / format
```
Added value: +"google-fieldmask"
```

changedInput schema / properties / requestMask.includeField / description

Previous value: -"Required. Comma-separated list of person fields to be included in the response. Each path should start with `person.`: for example, `person.names` or `person.ph"New value: +"[query parameter] Required. Comma-separated list of person fields to be included in the response. Each path should start with `person.`: for example, `person.names` or `person.ph"

addedInput schema / properties / requestMask.includeField / format
```
Added value: +"google-fieldmask"
```

changedInput schema / properties / resourceName / description

Previous value: -"Required. The resource name of the person to provide information about. - To get information about the authenticated user, specify `people/me`. - To get informa"New value: +"[URL path segment] Required. The resource name of the person to provide information about. - To get information about the authenticated user, specify `people/me`. - To get informa"

addedInput schema / properties / resourceName / pattern
```
Added value: +"^people/[^/]+$"
```

changedInput schema / properties / sources / items / description

Previous value: -"Optional. A mask of what source types to return. Defaults to READ_SOURCE_TYPE_PROFILE and READ_SOURCE_TYPE_CONTACT if not set."New value: +"[query parameter] Optional. A mask of what source types to return. Defaults to READ_SOURCE_TYPE_PROFILE and READ_SOURCE_TYPE_CONTACT if not set. Values: `READ_SOURCE_TYPE_UNSPECIFIED` = Unspecified.; `READ_SOURCE_TYPE_PROFILE` = Returns SourceType.ACCOUNT, SourceType.DOMAIN_PROFILE, and SourceType.PROFILE.; `READ_SOURCE_TYPE_CONTACT` = Returns SourceType.CONTACT.; `READ_SOURCE_TYPE_DOMAIN_CONTACT` = Returns SourceType.DOMAIN_CONTACT.; `READ_SOURCE_TYPE_OTHER_CONTACT` = Returns SourceType.OTHER_CONTACT.."

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "properties": {
+    "addresses": {
+      "items": {
+        "properties": {
+          "city": {
+            "type": "string"
+          },
+          "country": {
+            "type": "string"
+          },
+          "countryCode": {
+            "type": "string"
+          },
+          "extendedAddress": {
+            "type": "string"
+          },
+          "formattedType": {
+            "type": "string"
+          },
+          "formattedValue": {
+            "type": "string"
+          },
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "poBox": {
+            "type": "string"
+          },
+          "postalCode": {
+            "type": "string"
+          },
+          "region": {
+            "type": "string"
+          },
+          "streetAddress": {
+            "type": "string"
+          },
+          "type": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "ageRange": {
+      "enum": [
+        "AGE_RANGE_UNSPECIFIED",
+        "LESS_THAN_EIGHTEEN",
+        "EIGHTEEN_TO_TWENTY",
+        "TWENTY_ONE_OR_OLDER"
+      ],
+      "type": "string"
+    },
+    "ageRanges": {
+      "items": {
+        "properties": {
+          "ageRange": {
+            "enum": [
+              "AGE_RANGE_UNSPECIFIED",
+              "LESS_THAN_EIGHTEEN",
+              "EIGHTEEN_TO_TWENTY",
+              "TWENTY_ONE_OR_OLDER"
+            ],
+            "type": "string"
+          },
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "biographies": {
+      "items": {
+        "properties": {
+          "contentType": {
+            "enum": [
+              "CONTENT_TYPE_UNSPECIFIED",
+              "TEXT_PLAIN",
+              "TEXT_HTML"
+            ],
+            "type": "string"
+          },
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "value": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "birthdays": {
+      "items": {
+        "properties": {
+          "date": {
+            "properties": {
+              "day": {
+                "type": "integer"
+              },
+              "month": {
+                "type": "integer"
+              },
+              "year": {
+                "type": "integer"
+              }
+            },
+            "type": "object"
+          },
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "text": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "braggingRights": {
+      "items": {
+        "properties": {
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "value": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "calendarUrls": {
+      "items": {
+        "properties": {
+          "formattedType": {
+            "type": "string"
+          },
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "type": {
+            "type": "string"
+          },
+          "url": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "clientData": {
+      "items": {
+        "properties": {
+          "key": {
+            "type": "string"
+          },
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "value": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "coverPhotos": {
+      "items": {
+        "properties": {
+          "default": {
+            "type": "boolean"
+          },
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "url": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "emailAddresses": {
+      "items": {
+        "properties": {
+          "displayName": {
+            "type": "string"
+          },
+          "formattedType": {
+            "type": "string"
+          },
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "type": {
+            "type": "string"
+          },
+          "value": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "etag": {
+      "type": "string"
+    },
+    "events": {
+      "items": {
+        "properties": {
+          "date": {
+            "properties": {
+              "day": {
+                "type": "integer"
+              },
+              "month": {
+                "type": "integer"
+              },
+              "year": {
+                "type": "integer"
+              }
+            },
+            "type": "object"
+          },
+          "formattedType": {
+            "type": "string"
+          },
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "type": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "externalIds": {
+      "items": {
+        "properties": {
+          "formattedType": {
+            "type": "string"
+          },
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "type": {
+            "type": "string"
+          },
+          "value": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "fileAses": {
+      "items": {
+        "properties": {
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "value": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "genders": {
+      "items": {
+        "properties": {
+          "addressMeAs": {
+            "type": "string"
+          },
+          "formattedValue": {
+            "type": "string"
+          },
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "value": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "imClients": {
+      "items": {
+        "properties": {
+          "formattedProtocol": {
+            "type": "string"
+          },
+          "formattedType": {
+            "type": "string"
+          },
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "protocol": {
+            "type": "string"
+          },
+          "type": {
+            "type": "string"
+          },
+          "username": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "interests": {
+      "items": {
+        "properties": {
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "value": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "locales": {
+      "items": {
+        "properties": {
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "value": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "locations": {
+      "items": {
+        "properties": {
+          "buildingId": {
+            "type": "string"
+          },
+          "current": {
+            "type": "boolean"
+          },
+          "deskCode": {
+            "type": "string"
+          },
+          "floor": {
+            "type": "string"
+          },
+          "floorSection": {
+            "type": "string"
+          },
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "type": {
+            "type": "string"
+          },
+          "value": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "memberships": {
+      "items": {
+        "properties": {
+          "contactGroupMembership": {
+            "properties": {
+              "contactGroupId": {
+                "type": "string"
+              },
+              "contactGroupResourceName": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "domainMembership": {
+            "properties": {
+              "inViewerDomain": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "metadata": {
+      "properties": {
+        "deleted": {
+          "type": "boolean"
+        },
+        "linkedPeopleResourceNames": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "objectType": {
+          "enum": [
+            "OBJECT_TYPE_UNSPECIFIED",
+            "PERSON",
+            "PAGE"
+          ],
+          "type": "string"
+        },
+        "previousResourceNames": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "sources": {
+          "items": {
+            "properties": {
+              "etag": {
+                "type": "string"
+              },
+              "id": {
+                "type": "string"
+              },
+              "profileMetadata": {
+                "properties": {
+                  "objectType": {
+                    "enum": [
+                      "OBJECT_TYPE_UNSPECIFIED",
+                      "PERSON",
+                      "PAGE"
+                    ],
+                    "type": "string"
+                  },
+                  "userTypes": {
+                    "items": {
+                      "enum": [
+                        "USER_TYPE_UNKNOWN",
+                        "GOOGLE_USER",
+                        "GPLUS_USER",
+                        "GOOGLE_APPS_USER"
+                      ],
+                      "type": "string"
+                    },
+                    "type": "array"
+                  }
+                },
+                "type": "object"
+              },
+              "type": {
+                "enum": [
+                  "SOURCE_TYPE_UNSPECIFIED",
+                  "ACCOUNT",
+                  "PROFILE",
+                  "DOMAIN_PROFILE",
+                  "CONTACT",
+                  "OTHER_CONTACT",
+                  "DOMAIN_CONTACT"
+                ],
+                "type": "string"
+              },
+              "updateTime": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    "miscKeywords": {
+      "items": {
+        "properties": {
+          "formattedType": {
+            "type": "string"
+          },
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "type": {
+            "enum": [
+              "TYPE_UNSPECIFIED",
+              "OUTLOOK_BILLING_INFORMATION",
+              "OUTLOOK_DIRECTORY_SERVER",
+              "OUTLOOK_KEYWORD",
+              "OUTLOOK_MILEAGE",
+              "OUTLOOK_PRIORITY",
+              "OUTLOOK_SENSITIVITY",
+              "OUTLOOK_SUBJECT",
+              "OUTLOOK_USER",
+              "HOME",
+              "WORK",
+              "OTHER"
+            ],
+            "type": "string"
+          },
+          "value": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "names": {
+      "items": {
+        "properties": {
+          "displayName": {
+            "type": "string"
+          },
+          "displayNameLastFirst": {
+            "type": "string"
+          },
+          "familyName": {
+            "type": "string"
+          },
+          "givenName": {
+            "type": "string"
+          },
+          "honorificPrefix": {
+            "type": "string"
+          },
+          "honorificSuffix": {
+            "type": "string"
+          },
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "middleName": {
+            "type": "string"
+          },
+          "phoneticFamilyName": {
+            "type": "string"
+          },
+          "phoneticFullName": {
+            "type": "string"
+          },
+          "phoneticGivenName": {
+            "type": "string"
+          },
+          "phoneticHonorificPrefix": {
+            "type": "string"
+          },
+          "phoneticHonorificSuffix": {
+            "type": "string"
+          },
+          "phoneticMiddleName": {
+            "type": "string"
+          },
+          "unstructuredName": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "nicknames": {
+      "items": {
+        "properties": {
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "type": {
+            "enum": [
+              "DEFAULT",
+              "MAIDEN_NAME",
+              "INITIALS",
+              "GPLUS",
+              "OTHER_NAME",
+              "ALTERNATE_NAME",
+              "SHORT_NAME"
+            ],
+            "type": "string"
+          },
+          "value": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "occupations": {
+      "items": {
+        "properties": {
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "value": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "organizations": {
+      "items": {
+        "properties": {
+          "costCenter": {
+            "type": "string"
+          },
+          "current": {
+            "type": "boolean"
+          },
+          "department": {
+            "type": "string"
+          },
+          "domain": {
+            "type": "string"
+          },
+          "endDate": {
+            "properties": {
+              "day": {
+                "type": "integer"
+              },
+              "month": {
+                "type": "integer"
+              },
+              "year": {
+                "type": "integer"
+              }
+            },
+            "type": "object"
+          },
+          "formattedType": {
+            "type": "string"
+          },
+          "fullTimeEquivalentMillipercent": {
+            "type": "integer"
+          },
+          "jobDescription": {
+            "type": "string"
+          },
+          "location": {
+            "type": "string"
+          },
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "name": {
+            "type": "string"
+          },
+          "phoneticName": {
+            "type": "string"
+          },
+          "startDate": {
+            "properties": {
+              "day": {
+                "type": "integer"
+              },
+              "month": {
+                "type": "integer"
+              },
+              "year": {
+                "type": "integer"
+              }
+            },
+            "type": "object"
+          },
+          "symbol": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          },
+          "type": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "phoneNumbers": {
+      "items": {
+        "properties": {
+          "canonicalForm": {
+            "type": "string"
+          },
+          "formattedType": {
+            "type": "string"
+          },
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "type": {
+            "type": "string"
+          },
+          "value": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "photos": {
+      "items": {
+        "properties": {
+          "default": {
+            "type": "boolean"
+          },
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "url": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "relations": {
+      "items": {
+        "properties": {
+          "formattedType": {
+            "type": "string"
+          },
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "person": {
+            "type": "string"
+          },
+          "type": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "relationshipInterests": {
+      "items": {
+        "properties": {
+          "formattedValue": {
+            "type": "string"
+          },
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "value": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "relationshipStatuses": {
+      "items": {
+        "properties": {
+          "formattedValue": {
+            "type": "string"
+          },
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "value": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "residences": {
+      "items": {
+        "properties": {
+          "current": {
+            "type": "boolean"
+          },
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "value": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "resourceName": {
+      "type": "string"
+    },
+    "sipAddresses": {
+      "items": {
+        "properties": {
+          "formattedType": {
+            "type": "string"
+          },
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "type": {
+            "type": "string"
+          },
+          "value": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "skills": {
+      "items": {
+        "properties": {
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "value": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "taglines": {
+      "items": {
+        "properties": {
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "value": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "urls": {
+      "items": {
+        "properties": {
+          "formattedType": {
+            "type": "string"
+          },
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "type": {
+            "type": "string"
+          },
+          "value": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "userDefined": {
+      "items": {
+        "properties": {
+          "key": {
+            "type": "string"
+          },
+          "metadata": {
+            "properties": {
+              "primary": {
+                "type": "boolean"
+              },
+              "source": {
+                "properties": {
+                  "etag": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "profileMetadata": {
+                    "type": "object"
+                  },
+                  "type": {
+                    "enum": [
+                      "SOURCE_TYPE_UNSPECIFIED",
+                      "ACCOUNT",
+                      "PROFILE",
+                      "DOMAIN_PROFILE",
+                      "CONTACT",
+                      "OTHER_CONTACT",
+                      "DOMAIN_CONTACT"
+                    ],
+                    "type": "string"
+                  },
+                  "updateTime": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sourcePrimary": {
+                "type": "boolean"
+              },
+              "verified": {
+                "type": "boolean"
+              }
+            },
+            "type": "object"
+          },
+          "value": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "type": "object"
+}

First observedOct 26, 2026

TDQS

A3.6/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the load and does disclose meaningful traits: it is an HTTP GET (read-only), it fails with a 400 if personFields is omitted, it returns JSON, and it explains how the request is assembled from typed parameters vs. body_file or the params map. It stops short of auth/scope requirements or pagination-like concerns, but the failure-mode disclosure is genuinely useful.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The core sentence and the people/me tip are front-loaded and earn their place, but the boilerplate about request bodies/body_file and the long undifferentiated sibling name dump dilute the message for what is a simple GET.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need not be described, and the description still covers the required field mask, the resource-name convention, and the failure condition. Only permission/scope context is missing, which is minor for a read tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 88%, so the baseline is 3. The description reinforces the people/me convention for resourceName and the mandatory personFields flag, which compensates slightly for the truncated schema text ('Valid values are: *'), but it adds no field-mask syntax or guidance on which fields to request.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a concrete verb and resource: fetch a person's information given a resource name, and it enumerates the sibling operations on the same resource so the agent can see it is the single-person read among them. It never explains how it relates to getBatchGet or searchContacts beyond listing names, so differentiation is present but shallow.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is only implied: 'Use `people/me` to indicate the authenticated user' and the warning that a 400 is returned when personFields is absent give operational context, but there is no explicit when-to-use-this-vs-a-sibling guidance (e.g., batching several people with getBatchGet). The trailing sibling list names alternatives without saying when to pick them.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server