Method: people.createContact

新しい連絡先を作成し、その連絡先の人的リソースを返します。

連絡先ソースのシングルトンであるフィールドに複数のフィールドが指定されていると、このリクエストは 400 エラーを返します。

  • 伝記
  • 誕生日
  • 性別
  • names

レイテンシとエラーの増加を避けるため、同じユーザーの変更リクエストを順次送信する必要があります。

HTTP リクエスト

POST https://people.googleapis.com/v1/people:createContact

この URL は gRPC Transcoding 構文を使用します。

クエリ パラメータ

パラメータ
personFields

string (FieldMask format)

必須。フィールド マスク。各ユーザーに返されるフィールドを制限します。複数のフィールドを指定する場合は、カンマで区切ります。設定しない場合、デフォルトですべてのフィールドが使用されます。指定できる値は次のとおりです。

  • addresses
  • ageRanges
  • 伝記
  • 誕生日
  • calendarUrls
  • clientData
  • カバー写真
  • emailAddresses
  • 予定
  • externalId
  • 性別
  • imClients
  • 関心
  • locales
  • 場所
  • メンバーシップ
  • metadata
  • その他のキーワード
  • names
  • ニックネーム
  • 職業
  • organizations
  • phoneNumbers
  • 写真
  • リレーション
  • SipAddress
  • skills
  • URL
  • ユーザー定義
sources[]

enum (ReadSourceType)

(省略可)返されるソースタイプのマスク。設定しない場合、デフォルトは READ_SOURCE_TYPE_CONTACTREAD_SOURCE_TYPE_PROFILE になります。

リクエスト本文

リクエストの本文には Person のインスタンスが含まれます。

レスポンスの本文

成功した場合、レスポンスの本文には Person のインスタンスが含まれます。

認証スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/contacts

詳しくは、承認ガイドをご覧ください。