Method: people.updateContactPhoto

連絡先の写真を更新します。

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

HTTP リクエスト

PATCH https://people.googleapis.com/v1/{resourceName=people/*}:updateContactPhoto

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

パスパラメータ

パラメータ
resourceName

string

必須。担当者のリソース名

リクエスト本文

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

JSON 表現
{
  "photoBytes": string,
  "personFields": string,
  "sources": [
    enum (ReadSourceType)
  ]
}
フィールド
photoBytes

string (bytes format)

必須。未加工の写真(バイト)

Base64 でエンコードされた文字列。

personFields

string (FieldMask format)

省略可。人物のどのフィールドが返されるかを制限するフィールド マスク。複数のフィールドを指定する場合は、フィールドをカンマで区切ります。設定しない場合のデフォルトは空です。この場合、POST の mut get はスキップされます。指定できる値は次のとおりです。

  • addresses
  • ageRanges
  • 伝記
  • 誕生日
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • イベント
  • externalIds
  • 性別
  • imClients
  • 関心
  • locales
  • 開催地
  • メンバーシップ
  • メタデータ
  • miscKeywords
  • names
  • ニックネーム
  • 職業
  • organizations
  • phoneNumbers
  • 写真
  • 関係
  • sipAddresses
  • skills
  • urls
  • userDefined
sources[]

enum (ReadSourceType)

省略可。返すソースタイプのマスク。設定しない場合、デフォルトは READ_SOURCE_TYPE_CONTACTREAD_SOURCE_TYPE_PROFILE です。

レスポンスの本文

連絡先の写真を更新するためのレスポンス。

成功すると、レスポンスの本文に次の構造のデータが含まれます。

JSON 表現
{
  "person": {
    object (Person)
  }
}
フィールド
person

object (Person)

UpdateContactPhotoRequest で personFields が設定されている場合は、更新された人物。それ以外の場合は設定されません。

承認スコープ

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

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

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