grr

Overview Schema Source Related Servers Discussions Admin

people.people.updateContact

Update an existing contact by replacing only the fields named in the update mask, leaving other person data unchanged.

Instructions

Update contact data for an existing contact person. Any non-contact data will not be modified. Any non-contact data in the person to update will be ignored. All fields specified in the update_mask will be replaced. The server returns a 400 error if person.metadata.sources is not specified for the contact to be updated or if there is no contact source. The server returns a 400 error with reason "failedPrecondition" if person.metadata.sources.etag is different than the contact's etag, which indicates the contact has changed since its data was read. Clients should get the latest person an [HTTP PATCH] — updates the resource; refused under --readonly safety profiles. Returns the API's response resource as JSON — request body is a JSON Person object accepting addresses, ageRange, ageRanges, biographies, birthdays, braggingRights, calendarUrls, clientData and 30 more fields; pass it via params or whole via body_file Siblings over the same resource: batchCreateContacts, batchDeleteContacts, batchUpdateContacts, createContact, deleteContact, deleteContactPhoto, get, getBatchGet, listDirectoryPeople, searchContacts, searchDirectoryPeople, 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. The body is a JSON Person object.
`personFields`	No	[query parameter] Optional. A field mask to restrict which fields on each person are returned. Multiple fields can be specified by separating them with commas. Defaults to all fi
`request_body`	No	Request body of type Person: pass it via `params` (merged into the built body) or whole via `body_file`.
`resourceName`	Yes	[URL path segment] The resource name for the person, assigned by the server. An ASCII string in the form of `people/{person_id}`.
`updatePersonFields`	No	[query parameter] Required. A field mask to restrict which fields on the person are updated. Multiple fields can be specified by separating them with commas. All updated fields w

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.

Changed2 schema fields changedOct 26, 2026

changedInput schema / properties / body_file / description

Previous value: -"Read the request body from this file ('-' for stdin) instead of building one from the parameters."New value: +"Read the request body from this file ('-' for stdin) instead of building one from the parameters. The body is a JSON Person object."

addedInput schema / properties / request_body

Added value: +{
+  "description": "Request body of type Person: pass it via `params` (merged into the built body) or whole via `body_file`.",
+  "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"
+}

Changed8 schema fields changedOct 26, 2026

changedInput schema / properties / personFields / description

Previous value: -"Optional. A field mask to restrict which fields on each person are returned. Multiple fields can be specified by separating them with commas. Defaults to all fi"New value: +"[query parameter] Optional. A field mask to restrict which fields on each person are returned. Multiple fields can be specified by separating them with commas. Defaults to all fi"

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

changedInput schema / properties / resourceName / description

Previous value: -"The resource name for the person, assigned by the server. An ASCII string in the form of `people/{person_id}`."New value: +"[URL path segment] The resource name for the person, assigned by the server. An ASCII string in the form of `people/{person_id}`."

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_CONTACT and READ_SOURCE_TYPE_PROFILE if not set."New value: +"[query parameter] Optional. A mask of what source types to return. Defaults to READ_SOURCE_TYPE_CONTACT and READ_SOURCE_TYPE_PROFILE 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.."

changedInput schema / properties / updatePersonFields / description

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

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

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

A4/5.0

Behavior4/5

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

With no annotations, the description does heavy lifting: it discloses that this is a PATCH-style mutation, the update_mask replacement semantics, the failedPrecondition/etag concurrency guard, the 400 when metadata.sources is missing, and readonly-profile refusal. That is strong behavioral context, though reversibility is unstated and the '[HTTP PATCH]' fragment is truncated.

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 front of the description is well ordered, but the middle sentence trails off into a broken fragment ('Clients should get the latest person an [HTTP PATCH]') and the 12-sibling enumeration is low-value bulk that crowds out the useful precondition guidance.

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?

For a 9-parameter mutating tool with nested objects, no annotations, and an output schema, the description covers the mutation semantics, error conditions, and body shape an agent needs. It does not explain auth scopes or rollback, but the return-value burden is already handled by the output schema.

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

Parameters4/5

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

Schema description coverage is 89%, so the baseline is 3; the description still earns credit by explaining update_mask replacement behavior and the params/body_file routing for the large Person body. Note it says 'update_mask' while the schema names the field 'updatePersonFields', a minor mismatch that could confuse mapping.

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

Purpose5/5

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

The description opens with a specific verb and resource ('Update contact data for an existing contact person') and immediately scopes what changes (fields in update_mask replaced, non-contact data untouched). Combined with the sibling list over the same resource, an agent can identify this as the single update-mutation for a person.

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?

It gives real workflow guidance — fetch the latest person, respect the etag precondition — and notes the tool is refused under --readonly safety profiles. However the 12 siblings are only enumerated, not differentiated, so the agent is left to infer when this tool is preferable to batchUpdateContacts or updateContactPhoto.

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

Deploy Server