REST Resource: accounts.locations.media

リソース: 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

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

MediaItemDataRef

Google My Business API を介してアップロードされた MediaItem の写真バイナリデータへの参照です。

media.startUpload を使用してデータ参照を作成し、[media.upload] にバイトをアップロードした後に media.create を呼び出すときにこの参照を使用します。

JSON 表現 
{
  "resourceName": string
}
フィールド
resourceName

string

このメディア アイテムのバイナリデータの一意の ID です。[media.upload] で写真データをアップロードし、media.create でこのバイトから新しいメディア アイテムを作成するときに使用されます。

バイトのアップロード例: curl -X POST -T{path_to_file} "http://mybusiness.googleapis.com/upload/v1/media/{resourceName}?uploadType=media"

media.create 呼び出しの場合は、これを MediaItem dataRef に設定します。

MediaFormat

メディア フォーマットの列挙型です。

列挙型
MEDIA_FORMAT_UNSPECIFIED 形式が指定されていません。
PHOTO メディア アイテムは写真です。このバージョンでは写真のみがサポートされています。
VIDEO メディア アイテムは動画です。

LocationAssociation

メディア アイテムがその場所とどのように関連付けられているかを示します。

JSON 表現 
{

  // Union field location_attachment_type can be only one of the following:
  "category": enum (Category),
  "priceListItemId": string
  // End of list of possible types for union field location_attachment_type.
}
フィールド
共用体フィールド location_attachment_type。ビジネスのメディアには、カテゴリまたは関連付けられている価格表アイテムの ID が必要です。位置情報以外のメディア（ローカル投稿の写真など）には、どちらも指定しないでください。location_attachment_type は次のいずれかになります。
category

enum (Category)

このビジネス写真が属するカテゴリです。
priceListItemId

string

このビジネス写真が関連付けられている価格表アイテムの ID です。

カテゴリ

メディア アイテム カテゴリの列挙型です。

列挙型
CATEGORY_UNSPECIFIED カテゴリが指定されていません。
COVER カバー写真です。ビジネスに指定できるカバー写真は 1 枚のみです。
PROFILE プロフィール写真です。ビジネスに指定できるプロフィール写真は 1 枚のみです。
EXTERIOR 外観のメディアです。
INTERIOR 内装のメディアです。
PRODUCT 商品のメディアです。
AT_WORK 「勤務中」のメディアです。
FOOD_AND_DRINK 食べ物と飲み物のメディアです。
MENU メニューのメディアです。
COMMON_AREA 共用エリアのメディアです。
ROOMS 部屋のメディアです。
TEAMS チームのメディアです。
ADDITIONAL その他の未分類のメディアです。

ディメンション

メディア アイテムのサイズです。

JSON 表現 
{
  "widthPixels": integer,
  "heightPixels": integer
}
フィールド
widthPixels

integer

メディア アイテムの幅（ピクセル単位）です。
heightPixels

integer

メディア アイテムの高さ（ピクセル単位）です。

MediaInsights

メディア アイテムに関するインサイトと統計情報です。

JSON 表現 
{
  "viewCount": string
}
フィールド
viewCount

string (int64 format)

出力のみ。メディア アイテムが表示された回数です。

帰属

投稿者の名前やプロフィール写真など、顧客メディア アイテムの帰属情報です。

JSON 表現 
{
  "profileName": string,
  "profilePhotoUrl": string,
  "takedownUrl": string,
  "profileUrl": string
}
フィールド
profileName

string

メディア アイテムが帰属するユーザー名です。
profilePhotoUrl

string

帰属先ユーザーのプロフィール写真のサムネイルの URL です。
takedownUrl

string

不適切なメディア アイテムを報告できる削除ページの URL です。
profileUrl

string

帰属先ユーザーの Google マップ プロフィール ページの URL。

Methods

create

 ビジネスの新しいメディア アイテムを作成します。

delete

 指定したメディア アイテムを削除します。

get

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

list

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

patch

 指定したメディア アイテムのメタデータを更新します。

startUpload

 メディア アイテムをアップロードするための MediaItemDataRef を生成します。