Method: contactGroups.create

認証されたユーザーが所有する新しい連絡先グループを作成する。

作成する連絡先グループ名は、ユーザーの連絡先グループに固有のものである必要があります。重複する名前でグループを作成しようとすると、HTTP 409 エラーが返されます。

レイテンシの増加や失敗を避けるため、同じユーザーに対する DoFn リクエストは順次送信する必要があります。

HTTP リクエスト

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

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

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "contactGroup": {
    object (ContactGroup)
  },
  "readGroupFields": string
}
フィールド
contactGroup

object (ContactGroup)

必須。作成する連絡先グループ。
readGroupFields

string (FieldMask format)

省略可。返されるグループのフィールドを制限するフィールド マスク。設定しない場合や空に設定した場合のデフォルトは metadata、groupType、name です。有効なフィールドは次のとおりです。

  • clientData
  • groupType
  • メタデータ
  • name

レスポンスの本文

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

認可スコープ

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

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

詳細については、承認ガイドをご覧ください。