Method: contactGroups.update

認証されたユーザーが所有する既存の連絡先グループの名前を更新します。

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

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

HTTP リクエスト

PUT https://people.googleapis.com/v1/{contactGroup.resourceName=contactGroups/*}

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

パスパラメータ

パラメータ
contactGroup.resourceName

string

サーバーによって割り当てられた連絡先グループのリソース名。contactGroups/{contactGroupId} 形式の ASCII 文字列。

リクエスト本文

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

JSON 表現 
{
  "contactGroup": {
    "resourceName": string,
    "etag": string,
    "metadata": {
      "updateTime": string,
      "deleted": boolean
    },
    "groupType": enum (GroupType),
    "name": string,
    "formattedName": string,
    "memberResourceNames": [
      string
    ],
    "memberCount": integer,
    "clientData": [
      {
        "key": string,
        "value": string
      }
    ]
  },
  "updateGroupFields": string,
  "readGroupFields": string
}
フィールド
contactGroup.etag

string

リソースの HTTP エンティティ タグ。ウェブ キャッシュの検証に使用されます。
contactGroup.metadata

object (ContactGroupMetadata)

出力のみ。連絡先グループに関するメタデータ。
contactGroup.groupType

enum (GroupType)

出力のみ。連絡先グループの種類。
contactGroup.name

string

グループ オーナーが設定した連絡先グループ名、またはシステム グループの名前。

contactGroups.create または contactGroups.update の場合、名前はユーザーの連絡先グループに対して一意である必要があります。重複する名前でグループを作成しようとすると、HTTP 409 エラーが返されます。
contactGroup.formattedName

string

出力のみ。閲覧者のアカウントの言語 / 地域またはシステム グループ名の Accept-Language HTTP ヘッダーのロケールで翻訳およびフォーマットされた名前。オーナーが設定したグループ名が名前と同じである。
contactGroup.memberResourceNames[]

string

出力のみ。連絡先グループのメンバーである連絡先担当者のリソース名のリスト。このフィールドは、GET リクエストに対してのみ値が入力され、GET リクエストで maxMembers と同じ数のメンバーのみを返します。
contactGroup.memberCount

integer

出力のみ。グループ内の連絡先の合計数。リクエストで指定されたメンバーの最大数は考慮されません。
contactGroup.clientData[]

object (GroupClientData)

グループのクライアント データ。
updateGroupFields

string (FieldMask format)

省略可。グループで更新するフィールドを制限するフィールド マスク。複数のフィールドを指定する場合は、フィールドをカンマで区切ります。未設定または空に設定した場合のデフォルトは name です。更新されたフィールドが置き換えられます。指定できる値は次のとおりです。

  • clientData
  • name
readGroupFields

string (FieldMask format)

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

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

レスポンスの本文

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

承認スコープ

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

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

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