REST Resource: accounts.locations.media.customers

リソース: MediaItem

単一のメディア アイテムです。

JSON 表現 
{
  "name": string,
  "mediaFormat": enum (MediaFormat),
  "locationAssociation": {
    object (LocationAssociation)
  },
  "googleUrl": string,
  "thumbnailUrl": string,
  "createTime": string,
  "dimensions": {
    object (Dimensions)
  },
  "insights": {
    object (MediaInsights)
  },
  "attribution": {
    object (Attribution)
  },
  "description": string,

  // Union field data can be only one of the following:
  "sourceUrl": string,
  "dataRef": {
    object (MediaItemDataRef)
  }
  // End of list of possible types for union field data.
}
フィールド
name

string

このメディア アイテムのリソース名です。accounts/{accountId}/locations/{locationId}/media/{mediaKey}
mediaFormat

enum (MediaFormat)

このメディア アイテムのフォーマットです。メディア アイテムの作成時に設定する必要があります。他のすべてのリクエストでは読み取り専用です。この設定は変更できません。
locationAssociation

object (LocationAssociation)

CreatePhoto を呼び出す場合は必須です。このメディア アイテムがビジネスにどのように関連付けられているかを表します。カテゴリ（EXTERIOR など）か、価格表アイテムの ID のいずれかを指定する必要があります。

これは、media.create を使用して新しいメディアをビジネスに追加する場合に必要です。ローカル投稿の写真など、他の種類のメディアの場合、このフィールドはありません。
googleUrl

string

出力のみ。このメディア アイテムについて Google がホストする URL です。この URL は後で変更される可能性があるため、静的なものではありません。動画の場合は、再生アイコンが重ねて表示されるプレビュー画像になります。
thumbnailUrl

string

出力のみ。提供されている場合は、このメディア アイテムのサムネイル画像の URL になります。
createTime

string (Timestamp format)

出力のみ。このメディア アイテムの作成時間です。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。
dimensions

object (Dimensions)

出力のみ。ピクセル単位のサイズ（幅と高さ）です。
insights

object (MediaInsights)

出力のみ。このメディア アイテムに関する統計情報です。
attribution

object (Attribution)

出力のみ。顧客メディア アイテムの帰属情報です。この帰属表示はユーザーに提供されたとおりに表示する必要があり、削除や変更は行わないでください。
description

string

このメディア アイテムの説明です。説明は Google My Business API を使用して変更することはできませんが、カバー写真以外の新しいメディア アイテムの作成時に設定できます。

共用体フィールド data。メディア アイテムのデータソースです。新しいメディア アイテムの作成時に、URL またはデータ参照を指定する必要があります。

PROFILE および COVER カテゴリを除き、すべての写真は短辺が 250 ピクセル以上で、ファイルサイズが 10,240 バイト以上である必要があります。

アップロードする写真はすべて、ビジネス プロフィールの写真に関するガイドラインに準拠している必要があります。data は次のいずれかになります。
sourceUrl

string

メディア アイテムを取得可能な、一般公開されている URL です。

作成時に、これまたは dataRef のいずれかを、メディア アイテムのソースを指定するよう設定する必要があります。

メディア アイテムの作成時に sourceUrl を使用した場合は、メディア アイテムが取得されるときにそのソース URL が入力されます。

このフィールドは更新できません。
dataRef

object (MediaItemDataRef)

入力のみ。media.startUpload メソッドによって取得されるメディア アイテムのバイナリデータへの参照。

メディア アイテムの作成時に、

sourceUrl

または

dataRef

を設定する必要があります。

Methods

get

 リクエストされた顧客メディア アイテムのメタデータを返します。

list

 顧客から提供されたビジネスに関連付けられているメディア アイテムのリストを返します。