新しい連絡先のバッチを作成し、新しい連絡先の PersonResponses を返します。
レイテンシやエラーの増加を避けるため、同じユーザーに対する変更リクエストは順番に送信する必要があります。
HTTP リクエスト
POST https://people.googleapis.com/v1/people:batchCreateContacts
この URL は gRPC Transcoding 構文を使用します。
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{ "contacts": [ { object ( |
フィールド | |
---|---|
contacts[] |
必須。作成する連絡先。1 回のリクエストで最大 200 件の連絡先を許可します。 |
readMask |
必須。レスポンスで返される各人物のフィールドを制限するフィールド マスク。複数のフィールドを指定する場合は、フィールドをカンマで区切ります。読み取りマスクが空の場合、post-mut-get はスキップされ、レスポンスでデータは返されません。指定できる値は次のとおりです。
|
sources[] |
省略可。投稿の変更読み取りで返すソースタイプのマスク。設定しない場合、デフォルトは |
レスポンスの本文
失敗した場合は、無効な連絡先ごとのエラーのリストを含む BatchCreateContactsErrorDetails
を返します。
連絡先のバッチ作成リクエストに対するレスポンス。
成功すると、レスポンスの本文に次の構造のデータが含まれます。
JSON 表現 |
---|
{
"createdPeople": [
{
object ( |
フィールド | |
---|---|
createdPeople[] |
作成された連絡先(リクエスト |
承認スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/contacts
詳しくは、承認ガイドをご覧ください。
ContactToCreate
新しく作成されたソースに入力するための個人データを含むラッパー。
JSON 表現 |
---|
{
"contactPerson": {
object ( |
フィールド | |
---|---|
contactPerson |
必須。新しく作成されたソースに挿入する個人データ。 |