grr

Overview Schema Source Related Servers Discussions Admin

people.people.createContact

Creates a new contact from a JSON Person object and returns the resulting person resource, so you can add people to Google Contacts through the grr MCP server.

Instructions

Create a new contact and return the person resource for that contact. The request returns a 400 error if more than one field is specified on a field that is a singleton for contact sources: * biographies * birthdays * genders * names Mutate requests for the same user should be sent sequentially to avoid increased latency and failures [HTTP POST] — creates or triggers a change; 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, deleteContact, deleteContactPhoto, get, getBatchGet, listDirectoryPeople, searchContacts, searchDirectoryPeople, updateContact, updateContactPhoto.

Input Schema

Name	Required	Description
`query`	No	Extra KEY=VALUE query pairs for endpoints whose parameters Discovery does not describe.
`params`	No	Parameter map merged into the request; typed parameters win.
`dry_run`	No	Return the request that would be sent, without sending it.
`sources`	No
`body_file`	No	Read the request body from this file ('-' for stdin) instead of building one from the parameters. The body is a JSON Person object.
`personFields`	No	[query parameter] Required. 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`.

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"
+}

Changed4 schema fields changedOct 26, 2026

changedInput schema / properties / personFields / description

Previous value: -"Required. 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] Required. 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 / 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.."

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.3/5.0

Behavior5/5

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

With no annotations provided, the description carries the full behavioral burden and does so well: it discloses the 400 error condition for multiple singleton fields, the sequential-request requirement, that this is an HTTP POST mutation, that it is refused under --readonly safety profiles, and what the response returns. These details give the agent strong operational context beyond the bare tool name.

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

Conciseness4/5

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

The core purpose is front-loaded in the first sentence, followed by error handling, mutation guidance, request format, and sibling tools. It is dense but largely purposeful, though the long sibling list adds length without explaining how those alternatives differ.

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 complex create operation with a large nested Person body and an output schema, the description covers the essential behavioral context: error conditions, mutation safety, request body format, and response return. It leaves some peripheral details such as auth scopes and field-mask behavior to the schema, but is complete enough for correct invocation in most cases.

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

Parameters3/5

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

Schema description coverage is high at 86%, so the schema already documents most parameters, including query, params, dry_run, sources, personFields, body_file, and the large Person request body. The description adds some useful routing context by noting the body can be passed via params or whole via body_file, but it does not materially expand parameter semantics beyond what the schema already provides.

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 states a specific verb and resource: 'Create a new contact and return the person resource for that contact.' It clearly distinguishes this operation from sibling tools such as updateContact, deleteContact, and batchCreateContacts by naming creation of a new contact as the action.

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

Usage Guidelines4/5

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

The description gives clear context for when to use this tool: creating a new contact, plus the operational guideline that mutate requests for the same user should be sent sequentially. It lists sibling tools over the same resource but does not explicitly explain when to choose batchCreateContacts or updateContact instead, so it stops short of full alternative routing guidance.

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

Deploy Server