Package google.mybusiness.v4

作成するメディアアイテム。

DeleteLocalPostRequest

DeleteLocalPost に対するリクエストメッセージ。

フィールド

フィールド
`name`	`string` 削除するローカル投稿の名前。

name

string

削除するローカル投稿の名前。

DeleteMediaItemRequest

Media.DeleteMediaItem に対するリクエストメッセージです。

フィールド

フィールド
`name`	`string` 削除するメディアアイテムの名前。

name

string

削除するメディアアイテムの名前。

DeleteReviewReplyRequest

Reviews.DeleteReviewReply に対するリクエストメッセージ。

フィールド

フィールド
`name`	`string` 削除するクチコミへの返信の名前。

name

string

削除するクチコミへの返信の名前。

DietaryRestriction

食品の栄養情報。

列挙型
`DIETARY_RESTRICTION_UNSPECIFIED`	食事タイプが指定されていません
`HALAL`	ハラル料理であることを示す表記。
`KOSHER`	コーシャ料理であることを示す表記。
`ORGANIC`	料理がオーガニック料理であることを示す。
`VEGAN`	ビーガン料理としての食品の表記。
`VEGETARIAN`	料理がベジタリアン料理であることを示す表記。

ErrorDetail

検証エラーまたは内部エラーの原因となったエラーの詳細です。

フィールド
`code`	`int32` ステータスコード。`ErrorCode` の列挙値である必要があります。
`field`	`string` リクエスト本文のフィールドへのパス。値は、プロトコルバッファフィールドを識別する、ドットで区切られた識別子のシーケンスです。たとえば、「error_details.field」ではこのフィールドが識別されます。
`message`	`string` フィールドが失敗の原因となった理由の説明。メッセージは英語で表示され、ユーザーへの表示には適していない可能性があります。
`value`	`string` リクエストに失敗した値。
`field_index`	`int32` このエラーを生成したリクエストフィールドが繰り返される場合、検証が失敗する原因となったそのフィールド内のエントリーのゼロベースのインデックスが含まれます。

ErrorCode

ErrorDetail のエラーコード:

1 ～ 199: すべてのフィールドに適用される共通のエラーコードです。
1000 ～ 1099: 写真関連のエラーコードです。
1100 ～ 1199: 住所関連および緯度や経度関連のエラーコードです。
1200 ～ 1299: カテゴリ関連のエラーコードです。
1300 ～ 1399: 操作関連のエラーコードです。

列挙型
`ERROR_CODE_UNSPECIFIED`	汎用のエラーコードです。
`MISSING_VALUE`	必要な値が指定されていません。
`INVALID_VALUE`	無効な値が指定されました。
`INVALID_CHARACTERS`	無効な文字が見つかりました。
`TOO_MANY_ITEMS`	繰り返しフィールドに、最大数を超える数の項目が指定されました。
`READ_ONLY`	読み取り専用フィールドは変更できません。
`OVERLAPPING_RANGES`	繰り返しフィールド内の項目の範囲が相互に重複しています。
`INVERTED_RANGE`	指定した範囲が逆です。範囲が空の場合も含まれます。
`VALUE_OUTSIDE_ALLOWED_RANGE`	指定した値が許容範囲外です。
`MISSING_DEPENDENT_FIELD`	必須の依存フィールドがありません。
`FIELD_HAS_DEPENDENCIES`	依存フィールドに必要なフィールドであるため、削除できません。
`UNSUPPORTED_VALUE`	指定した値は、有効である可能性はありますが、他の制約のためにサポートされていません。
`EXPIRED_VALUE`	指定した値は有効期限が切れており、無効になっています。
`PHOTO_FETCH_FAILED`	指定した URL から写真を取得できませんでした。
`PHOTO_UPLOAD_FAILED`	指定した URL から写真をアップロードできませんでした。
`GEOCODE_ERROR`	緯度と経度の自動判別中にエラーが発生しました。
`LAT_LNG_OUTSIDE_COUNTRY`	指定した緯度と経度が、指定した国の中にありません。
`LAT_LNG_REQUIRED`	緯度と経度を指定する必要があります。
`LAT_LNG_TOO_FAR_FROM_ADDRESS`	緯度と経度が対になる住所から離れすぎています。
`CATEGORY_NOT_VERIFIED`	指定したカテゴリが未確認です。
`OPERATION_EXECUTION_ERROR`	一般的なオペレーション実行エラー。
`OPERATION_UNSUPPORTED_UNDER_ACCOUNT_CONDITION`	アカウントの状態が原因で、操作は対象外です。
`LOCATION_DISABLED_FOR_LOCAL_POST_API`	ビジネスがローカル投稿 API で無効になっています。
`STALE_DATA`	一部のフィールドの提案値が、既存の値と比較して古い。

FoodMenu

料理を提供するビジネスのメニュー。

フィールド
`labels[]`	`MenuLabel` 必須。メニューの言語タグ付きのラベルです。例: 「メニュー」、「ランチスペシャル」。表示名は 140 文字以下、説明は 1,000 文字以下にしてください。ラベルは少なくとも 1 セット必要です。
`source_url`	`string` 省略可。移動先のウェブページがある場合のメニューのソース URL。
`sections[]`	`FoodMenuSection` 必須。メニューのセクション。
`cuisines[]`	`Cuisine` 省略可。フードメニューの料理情報。このフィールドを指定することを強くおすすめします。

料理

レストランの料理に関する情報。

列挙型
`CUISINE_UNSPECIFIED`	料理が指定されていません
`AMERICAN`	アメリカ料理
`ASIAN`	アジア料理
`BRAZILIAN`	ブラジル料理
`BREAK_FAST`	朝食
`BRUNCH`	ブランチ
`CHICKEN`	ニワトリ
`CHINESE`	中華料理
`FAMILY`	ファミリースタイルの料理
`FAST_FOOD`	ファストフード
`FRENCH`	フランス料理
`GREEK`	ギリシャ料理
`GERMAN`	ドイツ料理
`HAMBURGER`	ハンバーガー
`INDIAN`	インド料理
`INDONESIAN`	インドネシア料理
`ITALIAN`	イタリア料理
`JAPANESE`	日本料理
`KOREAN`	韓国料理
`LATIN_AMERICAN`	ラテンアメリカ料理
`MEDITERRANEAN`	地中海料理
`MEXICAN`	メキシコ料理
`PAKISTANI`	パキスタン料理
`PIZZA`	ピザ
`SEAFOOD`	シーフード
`SPANISH`	スペイン料理
`SUSHI`	寿司
`THAI`	タイ料理
`TURKISH`	トルコ料理
`VEGETARIAN`	ベジタリアン料理
`VIETNAMESE`	ベトナム料理
`OTHER_CUISINE`	その他の料理

FoodMenuItem

セクションの項目。料理自体にすることも、複数の FoodMenuItemOption を含めることもできます。

フィールド

フィールド
`labels[]`	`MenuLabel` 必須。このメニュー項目の言語タグ付きのラベルです。表示名は 140 文字以下、説明は 1,000 文字以下にしてください。ラベルは少なくとも 1 セット必要です。
`attributes`	`FoodMenuItemAttributes` 必須。アイテムの詳細な属性。アイテムのオプションが指定されている場合、これは基本属性と見なされ、各オプションに設定されます。
`options[]`	`FoodMenuItemOption` 省略可。これは、複数の異なるオプションがあり、ユーザーが選択する必要があるアイテムの場合に使用します。たとえば、ピザの「レギュラー」と「ラージ」などです。オプションを指定すると、商品レベルのラベルと属性が自動的に最初のオプションのラベルと属性になります。クライアントは、このフィールドで他の追加の食事オプションを指定するだけで済みます。

labels[]

必須。このメニュー項目の言語タグ付きのラベルです。表示名は 140 文字以下、説明は 1,000 文字以下にしてください。ラベルは少なくとも 1 セット必要です。

attributes

FoodMenuItemAttributes

必須。アイテムの詳細な属性。アイテムのオプションが指定されている場合、これは基本属性と見なされ、各オプションに設定されます。

options[]

FoodMenuItemOption

省略可。これは、複数の異なるオプションがあり、ユーザーが選択する必要があるアイテムの場合に使用します。たとえば、ピザの「レギュラー」と「ラージ」などです。オプションを指定すると、商品レベルのラベルと属性が自動的に最初のオプションのラベルと属性になります。クライアントは、このフィールドで他の追加の食事オプションを指定するだけで済みます。

FoodMenuItemAttributes

料理の属性。

フィールド
`price`	`Money` 省略可。料理の価格。
`spiciness`	`Spiciness` 省略可。料理の辛さレベル。
`allergen[]`	`Allergen` 省略可。料理に関連付けられたアレルゲン。このフィールドを指定することを強くおすすめします。
`dietary_restriction[]`	`DietaryRestriction` 省略可。料理の食事に関する情報。このフィールドを指定することを強くおすすめします。
`nutrition_facts`	`NutritionFacts` 省略可。料理オプションの栄養成分。このフィールドを指定することを強くおすすめします。
`ingredients[]`	`Ingredient` 省略可。料理オプションの材料。
`serves_num_people`	`int32` 省略可。この料理オプションで提供できる人数。
`preparation_methods[]`	`PreparationMethod` 省略可。料理のオプションの調理方法。
`portion_size`	`PortionSize` 省略可。注文のサイズ（アイテムの単位で表されます）。（例: 「串 4 本」、「6 個」）
`media_keys[]`	`string` 省略可。料理に関連付けられているメディアのメディアキー。写真メディアのみがサポートされています。複数の写真が関連付けられている場合、最初の写真が優先写真と見なされます。

材料

このメッセージは、料理の材料情報を表します。

フィールド

フィールド
`labels[]`	`MenuLabel` 必須。材料を説明するラベル。表示名は 140 文字以下、説明は 1,000 文字以下にしてください。ラベルは少なくとも 1 セット必要です。

labels[]

必須。材料を説明するラベル。表示名は 140 文字以下、説明は 1,000 文字以下にしてください。ラベルは少なくとも 1 セット必要です。

PortionSize

料理の 1 人分の量。

フィールド

フィールド
`quantity`	`int32` 必須。部分の番号。
`unit[]`	`MenuLabel` 必須。繰り返し name_info フィールドは、複数の言語の単位用です。

quantity

int32

必須。部分の番号。

unit[]

必須。繰り返し name_info フィールドは、複数の言語の単位用です。

FoodMenuItemOption

アイテムのオプション。ユーザーの明示的な選択が必要です。

フィールド

フィールド
`labels[]`	`MenuLabel` 必須。このメニュー項目のオプションの言語タグ付きラベル。例: 「ビーフパッタイ」、「ベジパッタイ」、「ピザ小」、「ピザ大」など。表示名は 140 文字以下、説明は 1,000 文字以下にしてください。ラベルは少なくとも 1 セット必要です。
`attributes`	`FoodMenuItemAttributes` 必須。商品オプションの詳細属性。個々の未指定の属性は、商品アイテム単位の属性をベースとして継承されます。

labels[]

必須。このメニュー項目のオプションの言語タグ付きラベル。例: 「ビーフパッタイ」、「ベジパッタイ」、「ピザ小」、「ピザ大」など。表示名は 140 文字以下、説明は 1,000 文字以下にしてください。ラベルは少なくとも 1 セット必要です。

attributes

FoodMenuItemAttributes

必須。商品オプションの詳細属性。個々の未指定の属性は、商品アイテム単位の属性をベースとして継承されます。

FoodMenuSection

メニューのセクション。複数の商品/料理を含めることができます。

フィールド

フィールド
`labels[]`	`MenuLabel` 必須。このメニューセクションの言語タグ付きラベル。表示名は 140 文字以下、説明は 1,000 文字以下にしてください。ラベルは少なくとも 1 セット必要です。
`items[]`	`FoodMenuItem` 必須。セクションの項目。各セクションには少なくとも 1 つの項目が必要です。

labels[]

必須。このメニューセクションの言語タグ付きラベル。表示名は 140 文字以下、説明は 1,000 文字以下にしてください。ラベルは少なくとも 1 セット必要です。

items[]

FoodMenuItem

必須。セクションの項目。各セクションには少なくとも 1 つの項目が必要です。

FoodMenus

料理を提供するビジネスのメニュー。

フィールド

フィールド
`name`	`string` 必須。このビジネスの Google 識別子です。`accounts/{account_id}/locations/{location_id}/foodMenus` の形式で表されます。
`menus[]`	`FoodMenu` 省略可。料理のメニューのコレクション。

name

string

必須。このビジネスの Google 識別子です。accounts/{account_id}/locations/{location_id}/foodMenus の形式で表されます。

menus[]

FoodMenu

省略可。料理のメニューのコレクション。

GetCustomerMediaItemRequest

Media.GetCustomerMediaItem に対するリクエストメッセージです。

フィールド

フィールド
`name`	`string` リクエストされた顧客メディアアイテムのリソース名。

name

string

リクエストされた顧客メディアアイテムのリソース名。

GetFoodMenusRequest

FoodMenu.GetFoodMenus のリクエストメッセージ

フィールド

フィールド
`name`	`string` 必須。このビジネスの Google 識別子です。`accounts/{account_id}/locations/{location_id}/foodMenus` の形式で表されます。
`read_mask`	`FieldMask` 省略可。返すフィールド。マスクが指定されていない場合は、完全な FoodMenu が返されます（「*」と同じ）。繰り返しフィールドの項目を個別に指定することはできません。たとえば、「name」と「menus」は有効なマスクですが、「menus.sections」は無効です。

name

string

必須。このビジネスの Google 識別子です。accounts/{account_id}/locations/{location_id}/foodMenus の形式で表されます。

read_mask

省略可。返すフィールド。マスクが指定されていない場合は、完全な FoodMenu が返されます（「*」と同じ）。繰り返しフィールドの項目を個別に指定することはできません。たとえば、「name」と「menus」は有効なマスクですが、「menus.sections」は無効です。

GetLocalPostRequest

LocalPosts.GetLocalPost に対するリクエストメッセージです。

フィールド

フィールド
`name`	`string` 取得するローカル投稿の名前。

name

string

取得するローカル投稿の名前。

GetMediaItemRequest

Media.GetMediaItem に対するリクエストメッセージです。

フィールド

フィールド
`name`	`string` リクエストされたメディアアイテムの名前。

name

string

リクエストされたメディアアイテムの名前。

GetReviewRequest

Reviews.GetReview に対するリクエストメッセージ。

フィールド

フィールド
`name`	`string` 取得するクチコミの名前。

name

string

取得するクチコミの名前。

InternalError

内部エラーについての説明です。

フィールド

フィールド
`error_details[]`	`ErrorDetail` 個々のエラーに関する詳細です。

error_details[]

ErrorDetail

個々のエラーに関する詳細です。

ListCustomerMediaItemsRequest

Media.ListCustomerMediaItems に対するリクエストメッセージです。

フィールド

フィールド
`parent`	`string` 顧客のメディアアイテムを一覧表示するビジネスの名前です。
`page_size`	`int32` 1 ページあたりで返すメディアアイテム数です。デフォルト値は 100、サポートされている最大ページサイズは 200 です。
`page_token`	`string` 指定すると、メディアアイテムの次のページを返します。

parent

string

顧客のメディアアイテムを一覧表示するビジネスの名前です。

page_size

int32

1 ページあたりで返すメディアアイテム数です。デフォルト値は 100、サポートされている最大ページサイズは 200 です。

page_token

string

指定すると、メディアアイテムの次のページを返します。

ListCustomerMediaItemsResponse

Media.ListCustomerMediaItems に対するレスポンスメッセージです。

フィールド

media_items[]

返されるメディアアイテムの一覧。

total_media_item_count

int32

このビジネスのメディアアイテムの合計数です。ページ分けとは無関係です。結果が複数ページにわたる場合は特に、この数値はおおよその値になります。

next_page_token

string

リクエストしたページサイズを上回る数のメディアアイテムがある場合、このフィールドには、後続の ListCustomerMediaItems の呼び出しでメディアアイテムの次のページを取得するためのトークンが入力されます。

ListLocalPostsRequest

ListLocalPosts に対するリクエストメッセージ

フィールド

parent

string

ローカル投稿の一覧を取得するビジネスの名前です。

page_size

int32

1 ページあたりで返すローカル投稿の数。デフォルトは 20 です。最小値は 1、最大ページサイズは 100 です。

page_token

string

指定すると、ローカル投稿の次のページが返されます。

ListLocalPostsResponse

ListLocalPosts に対するレスポンスメッセージ

フィールド

local_posts[]

LocalPost

返されるローカル投稿の一覧。

next_page_token

string

リクエストしたページサイズを上回る数のローカル投稿がある場合、このフィールドには、後続の ListLocalPosts の呼び出しでローカル投稿の次のページを取得するためのトークンが入力されます。

ListMediaItemsRequest

Media.ListMediaItems に対するリクエストメッセージです。

フィールド

parent

string

メディアアイテムを一覧表示するビジネスの名前です。

page_size

int32

1 ページあたりで返すメディアアイテム数です。デフォルト値は 100 です。この値は、My Business API でビジネスに追加可能なメディアアイテムとしてサポートされる最大数でもあります。最大ページサイズは 2,500 です。

page_token

string

指定すると、メディアアイテムの次のページを返します。

ListMediaItemsResponse

Media.ListMediaItems に対するレスポンスメッセージです。

フィールド

media_items[]

返されるメディアアイテムの一覧。

total_media_item_count

int32

このビジネスのメディアアイテムの合計数です。ページ分けとは無関係です。

next_page_token

string

リクエストしたページサイズを上回る数のメディアアイテムがある場合、このフィールドには、後続の ListMediaItems の呼び出しでメディアアイテムの次のページを取得するためのトークンが入力されます。

ListReviewsRequest

Reviews.ListReviews に対するリクエストメッセージ。

フィールド
`parent`	`string` クチコミを取得するビジネスの名前です。
`page_size`	`int32` 1 ページあたりで取得するクチコミ数です。`page_size` の最大値は 50 です。
`page_token`	`string` 指定すると、クチコミの次のページが取得されます。
`order_by`	`string` クチコミの並べ替えの基準とするフィールドを指定します。指定されていない場合は、返されるクチコミの順序はデフォルトの `update_time desc` になります。並べ替えで有効な順序は `rating`、`rating desc`、`update_time desc` です。

ListReviewsResponse

Reviews.ListReviews に対するレスポンスメッセージ。

フィールド
`reviews[]`	`Review` クチコミです。
`average_rating`	`double` このビジネスに対するすべてのクチコミの平均評価です。1 から 5 の 5 段階評価で、5 が最高評価です。
`total_review_count`	`int32` このビジネスのクチコミの総数です。
`next_page_token`	`string` クチコミの数がリクエストしたページサイズを超えた場合、このフィールドには、後続の ListReviews への呼び出しでクチコミの次のページを取得するためのトークンが入力されます。取得するクチコミがそれ以上ない場合、このフィールドはレスポンスに含められません。

LocalPost

ビジネスについてのローカル投稿を表します。

フィールド
`name`	`string` 出力専用。このローカル投稿を `accounts/{account_id}/locations/{location_id}/localPosts/{local_post_id}` の形式で表した Google 識別子です。
`language_code`	`string` ローカル投稿の言語。
`summary`	`string` ローカル投稿の説明文または本文。
`call_to_action`	`CallToAction` プロモーションをクリックしたユーザーが誘導される URL です。トピックタイプが `OFFER` の場合は無視されます。
`create_time`	`Timestamp` 出力専用。投稿が作成された時間です。
`update_time`	`Timestamp` 出力専用。ユーザーが最後に投稿を変更した時間です。
`scheduled_time`	`Timestamp` 設定されている場合、投稿が公開される日時を決定します。ユーザーが設定して、投稿を事前にスケジュールできます。
`recurring_instance_time (deprecated)`	`Timestamp` この項目は非推奨です。出力専用。非推奨: 代わりに、`event.recurring_instance_time` を使用してください。このフィールドは今後のバージョンで削除される予定です。出力専用。投稿の最新の定期的なインスタンスが更新された時刻。
`event`	`LocalPostEvent` イベント情報。トピックタイプ `EVENT` と `OFFER` では必須です。
`state`	`LocalPostState` 出力専用。投稿がライフサイクルのどの段階にあるのかを表すステータスです。
`media[]`	`MediaItem` 投稿に関連付けられているメディアです。LocalPost MediaItem でサポートされているデータフィールドは source_url のみです。
`search_url`	`string` 出力専用。Google 検索のローカル投稿へのリンクです。このリンクは、ソーシャルメディア、メール、テキストメッセージなどで投稿を共有するために使用できます。
`topic_type`	`LocalPostTopicType` 必須。投稿のトピックタイプ（標準、イベント、特典、アラート）です。
`alert_type`	`AlertType` 投稿を作成するアラートの種類。このフィールドは、topic_type が Alert の投稿にのみ適用され、アラートのサブタイプとして機能します。
共用体フィールド `topic_type_specific_fields`。トピックタイプの特定のフィールド。`topic_type_specific_fields` は次のいずれかになります。
`offer`	`LocalPostOffer` 特典に関する投稿の追加データです。topic_type が OFFER の場合にのみ設定する必要があります。

LocalPostState

投稿のステータスを表します。

列挙型
`LOCAL_POST_STATE_UNSPECIFIED`	ステータスが指定されていません。
`REJECTED`	この投稿は、コンテンツポリシー違反により不承認となっています。
`LIVE`	この投稿は公開されており、検索結果に現在表示されています。
`PROCESSING`	この投稿は処理中で、検索結果に表示されていません。
`SCHEDULED`	この投稿は将来の公開がスケジュールされており、検索結果に表示されていません。
`RECURRING`	この投稿は定期的な投稿であり、検索結果に現在表示されています。

LocalPostEvent

ローカル投稿に掲載されるイベントに関連するすべての情報です。

フィールド
`title`	`string` イベントの名前。
`schedule`	`TimeInterval` イベントの開始日時と終了日時。
`recurrence_info`	`RecurrenceInfo` 省略可。定期的な投稿の頻度に関する情報を保存します。投稿が定期的な投稿の場合にのみ設定されます。
`recurring_instance_time`	`Timestamp` 出力専用。投稿の最新の定期的なインスタンスが更新された時刻。

RecurrenceInfo

ローカル投稿の定期的な投稿に関する情報を表します。

フィールド
`series_end_time`	`Timestamp` 省略可。定期的なシリーズの終了時刻。
共用体フィールド `occurrence_pattern`。定期的な投稿の発生パターン。`occurrence_pattern` は次のいずれかになります。
`daily_pattern`	`DailyOccurrencePattern` 毎日の発生パターン。
`weekly_pattern`	`WeeklyOccurrencePattern` 週単位の発生パターン。
`monthly_pattern`	`MonthlyOccurrencePattern` 月単位の発生パターン。

DailyOccurrencePattern

この型にはフィールドがありません。

毎日の発生パターンを表します。

MonthlyOccurrencePattern

月単位の繰り返しパターンを表します。

フィールド

共用体フィールド monthly_option。月単位の繰り返しパターンの繰り返しオプション。monthly_option は次のいずれかになります。

day_of_month

int32

日にちです。

day_of_week_occurrence

DayOfWeekOccurrence

月の曜日。曜日は、イベントの開始時間の曜日から推測されます。たとえば、イベントが金曜日に開始され、day_of_week_occurrence が SECOND の場合、イベントは毎月第 2 金曜日に繰り返されます。

DayOfWeekOccurrence

月内の曜日の出現回数。

列挙型
`DAY_OF_WEEK_OCCURRENCE_UNSPECIFIED`	指定されていない曜日の発生。
`FIRST`	月の最初の曜日。
`SECOND`	月の第 2 曜日。
`THIRD`	月の第 3 曜日。
`FOURTH`	月の 4 番目の曜日。
`LAST`	月の最終日。

WeeklyOccurrencePattern

週単位の繰り返しパターンを表します。

フィールド

days_of_week[]

DayOfWeek

省略可。特典/イベントの曜日リスト。空の場合、投稿はイベントの schedule.start_time と同じ曜日に繰り返されます。

LocalPostOffer

特典に関する投稿専用のフィールドです。

フィールド

coupon_code

string

省略可。店舗またはオンラインで使用可能な特典コードです。

redeem_online_url

string

省略可。特典を利用するためのオンラインリンクです。

terms_conditions

string

省略可。特典の利用規約。

LocalPostTopicType

ローカル投稿のトピックタイプです。さまざまなテンプレートを選択して投稿を作成、表示するために使用されます。

列挙型
`LOCAL_POST_TOPIC_TYPE_UNSPECIFIED`	投稿のタイプが指定されていません。
`STANDARD`	投稿に概要や画像などの基本情報が含まれています。
`EVENT`	投稿に基本情報とイベントが含まれています。
`OFFER`	投稿に、基本情報とイベントや特典に関連するコンテンツ（クーポンコードなど）が含まれています。
`ALERT`	進行中のイベントに関連する、優先度が高く、迅速な通知です。このタイプの投稿は、作成できない場合があります。

LocationReview

ビジネス情報のクチコミを表します。

フィールド

name

string

ビジネスのリソース名。

review

Review

ビジネスに関するクチコミ。

MediaItem

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

フィールド
`name`	`string` このメディアアイテムのリソース名。`accounts/{account_id}/locations/{location_id}/media/{media_key}`
`media_format`	`MediaFormat` このメディアアイテムのフォーマットです。メディアアイテムの作成時に設定する必要があります。他のすべてのリクエストでは読み取り専用です。この設定は変更できません。
`location_association`	`LocationAssociation` `CreatePhoto` を呼び出す際に必要です。このメディアアイテムがビジネスにどのように関連付けられているかを表します。カテゴリ（EXTERIOR など）または価格表アイテムの ID を指定する必要があります。このフィールドは、`CreateMediaItem` を使って新しいメディアをビジネスに追加するときに必要です。ローカル投稿の写真など、他の種類のメディアの場合、このフィールドはありません。
`google_url`	`string` 出力専用。このメディアアイテムについて Google がホストする URL です。この URL は後で変更される可能性があるため、静的なものではありません。動画の場合は、再生アイコンがオーバーレイされたプレビュー画像になります。
`thumbnail_url`	`string` 出力専用。提供されている場合は、このメディアアイテムのサムネイル画像の URL になります。
`create_time`	`Timestamp` 出力専用。このメディアアイテムの作成時間。
`dimensions`	`Dimensions` 出力専用。ピクセル単位のサイズ（幅と高さ）です。
`insights (deprecated)`	`MediaInsights` この項目は非推奨です。出力専用。このメディアアイテムに関する統計情報です。
`attribution`	`Attribution` 出力専用。顧客メディアアイテムの帰属情報。この帰属情報はユーザーに提供するとおりに表示する必要があり、削除または変更してはなりません。
`description`	`string` このメディアアイテムについての説明です。My Business API で変更することはできませんが、カバー写真以外の新しいメディアアイテムの作成時に設定できます。
共用体フィールド `data`。メディアアイテムのデータソース。新しいメディアアイテムの作成時に、URL またはデータ参照を指定する必要があります。 `PROFILE` および `COVER` カテゴリを除き、すべての写真は短辺が 250 ピクセル以上で、ファイルサイズが 10,240 バイト以上である必要があります。アップロードする写真はすべて、Google マイビジネスの写真に関するガイドラインに準拠している必要があります。`data` は次のいずれかになります。
`source_url`	`string` メディアアイテムを取得可能な、一般公開されている URL です。作成時に、source_url または data_ref を、メディアアイテムのソースを指定するよう設定する必要があります。メディアアイテムの作成時に `source_url` を使用した場合は、メディアアイテムが取得されるときにそのソース URL が入力されます。このフィールドは更新できません。
`data_ref`	`MediaItemDataRef` 入力専用。`StartUploadMediaItemData` メソッドによって取得されたメディアアイテムのバイナリデータへの参照です。メディアアイテムの作成時に、 `sourceUrl` または `dataRef` を設定する必要があります。

アトリビューション

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

フィールド
`profile_name`	`string` メディアアイテムが帰属するユーザー名です。
`profile_photo_url`	`string` 帰属先ユーザーのプロフィール写真のサムネイルの URL。
`takedown_url`	`string` 不適切なメディアアイテムを報告できる削除ページの URL です。
`profile_url`	`string` 帰属先ユーザーの Google マッププロフィールページの URL です。

ディメンション

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

フィールド

width_pixels

int32

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

height_pixels

int32

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

LocationAssociation

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

フィールド

共用体フィールド location_attachment_type。ビジネスのメディアには、カテゴリまたは関連付けられている価格表アイテムの ID が必要です。ビジネス以外のメディア（ローカル投稿の写真など）には、どちらも含めないでください。location_attachment_type は次のいずれかになります。

category

Category

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

price_list_item_id

string

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

カテゴリ

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

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

MediaFormat

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

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

MediaInsights

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

フィールド

view_count

int64

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

MediaItemDataRef

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

StartUploadMediaItemData を使用してデータ参照を作成し、[UpdateMedia] にバイトをアップロードした後 CreateMediaItem を呼び出す際にこの参照を使います。

フィールド

resource_name

string

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

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

CreateMediaItem 呼び出しの場合、これを MediaItem data_ref として設定します。

MenuLabel

メニューとそのさまざまなサブコンポーネントを表示するときに使用するラベルです。

フィールド

display_name

string

必須。コンポーネントの表示名。

description

string

省略可。コンポーネントの補足情報。

language_code

string

省略可。言語の BCP 47 コード。その言語が利用できない場合、デフォルトで英語になります。

NutritionFacts

このメッセージは、料理の栄養成分を表します。

フィールド
`calories`	`CaloriesFact` 省略可。料理のカロリー。
`total_fat`	`NutritionFact` 省略可。特定の料理の脂肪に関する情報。
`cholesterol`	`NutritionFact` 省略可。特定の料理のコレステロールに関する情報。
`sodium`	`NutritionFact` 省略可。特定の料理のナトリウム情報。
`total_carbohydrate`	`NutritionFact` 省略可。特定の料理の炭水化物に関する情報。
`protein`	`NutritionFact` 省略可。特定の料理のタンパク質に関する情報。

CaloriesFact

このメッセージは、上限と下限の範囲でカロリー情報を示します。下限額を指定する必要があります。下限額と上限額はどちらも負でない数値です。

フィールド

lower_amount

int32

必須。カロリー摂取量を減らす

upper_amount

int32

省略可。カロリーの上限

unit

EnergyUnit

必須。指定されたカロリー情報の単位。

EnergyUnit

食品エネルギー（カロリー）の単位。

列挙型
`ENERGY_UNIT_UNSPECIFIED`	エネルギー単位が指定されていない
`CALORIE`	カロリー
`JOULE`	ジュール

MassUnit

質量に使用できる単位。

列挙型
`MASS_UNIT_UNSPECIFIED`	質量単位が指定されていません
`GRAM`	Gram
`MILLIGRAM`	ミリグラム

NutritionFact

このメッセージは、上限と下限の範囲で栄養情報を表し、質量単位で表すことができます。下限額を指定する必要があります。下限額と上限額はどちらも負でない数値です。

フィールド

lower_amount

double

必須。栄養価が低い

upper_amount

double

省略可。栄養の上限値

unit

MassUnit

必須。指定された栄養情報の単位。

PreparationMethod

料理の調理方法。

列挙型
`PREPARATION_METHOD_UNSPECIFIED`	調理方法が指定されていません
`BAKED`	ベイク処理メソッド
`BARBECUED`	バーベキュー
`BASTED`	Basted メソッド
`BLANCHED`	ブランチング方式
`BOILED`	Boiled メソッド
`BRAISED`	煮込み料理
`CODDLED`	コドルド法
`FERMENTED`	発酵法
`FRIED`	Fried メソッド
`GRILLED`	Grilled method
`KNEADED`	Kneaded メソッド
`MARINATED`	マリネ方法
`PAN_FRIED`	Pan fried method（フライパンで焼く方法）
`PICKLED`	Pickled メソッド
`PRESSURE_COOKED`	圧力調理法
`ROASTED`	Roasted メソッド
`SAUTEED`	ソテー
`SEARED`	Seared メソッド
`SIMMERED`	Simmered method
`SMOKED`	Smoked メソッド
`STEAMED`	蒸し料理
`STEEPED`	浸漬法
`STIR_FRIED`	炒め物
`OTHER_METHOD`	その他の方法

確認

出力専用。ビジネスについてのクチコミを表します。

フィールド
`name`	`string` リソース名。クチコミの場合は `accounts/{account_id}/locations/{location_id}/reviews/{review_id}` という形式になります。
`review_id`	`string` 暗号化された一意の ID です。
`reviewer`	`Reviewer` レビューを書いた人です。
`star_rating`	`StarRating` クチコミの評価です。
`comment`	`string` マークアップ付きの書式なしテキストによるクチコミの本文です。
`create_time`	`Timestamp` クチコミが投稿されたときのタイムスタンプです。
`update_time`	`Timestamp` クチコミが最後に変更されたときのタイムスタンプです。
`review_reply`	`ReviewReply` このクチコミに対するビジネスのオーナーまたは管理者による返信です。
`review_media_items[]`	`ReviewMediaItem` 出力専用。クチコミに関連付けられたメディアアイテム。
`review_reply_url`	`string` 出力専用。クチコミに返信する URL。

ReviewMediaItem

クチコミに関連付けられたメディアアイテム（写真または動画）を表します。

フィールド

thumbnail_url

string

出力専用。写真の FIFE URL。video_url が存在する場合は動画のサムネイルの FIFE URL。

thumbnail_label

string

出力専用。thumbnail_url の作成者が指定したラベル。

video_url

string

出力専用。再生可能な動画の URL。

審査担当者

クチコミの投稿者を表します。

フィールド

profile_photo_url

string

クチコミ投稿者のプロフィール写真へのリンクです。is_anonymous が false の場合にのみ入力されます。

display_name

string

クチコミ投稿者の名前です。is_anonymous が false の場合にのみクチコミ投稿者の実名が入力されます。

is_anonymous

bool

クチコミ投稿者が匿名のままにするよう設定しているかどうかを表します。

StarRating

星 5 つを最も高い評価とする評価です。

列挙型
`STAR_RATING_UNSPECIFIED`	指定されていません。
`ONE`	最高で星 5 つのうちの 1 つ星です。
`TWO`	最高で星 5 つのうちの 2 つ星です。
`THREE`	最高で星 5 つのうちの 3 つ星です。
`FOUR`	最高で星 5 つのうちの 4 つ星です。
`FIVE`	最高の評価です。

ReviewReply

クチコミに対するビジネスのオーナーまたは管理者による返信を表します。

フィールド
`comment`	`string` マークアップが付いた書式なしテキストとしての返信の本文です。最大長は 4,096 バイトです。
`update_time`	`Timestamp` 出力専用。返信が最後に変更されたときのタイムスタンプです。
`review_reply_state`	`State` 出力専用。クチコミへの返信の状態。
`policy_violation`	`PolicyViolation` 省略可。出力専用。不承認の原因となったポリシー違反。review_reply_state が REJECTED の場合にのみ入力されます。

PolicyViolation

標準化されたポリシー違反を表します。今後、新しい値が追加される可能性があります。クライアントは、不明な値を処理する準備をする必要があります。

列挙型
`POLICY_VIOLATION_UNSPECIFIED`	指定されていないポリシー違反を表します。
`ACCOUNT_RESTRICTED_AND_SUSPENDED`	このビジネスプロフィールに関連付けられた Google アカウントが制限されたため、ビジネスプロフィールが停止されました。
`ACCOUNT_RESTRICTED_AND_EDIT_REJECTED`	このビジネスプロフィールに関連付けられた Google アカウントが制限されているため、編集内容が承認されませんでした。ACCOUNT_RESTRICTED_AND_SUSPENDED とは異なり、ビジネスプロフィール自体は有効なままで、停止されません。
`ASSOCIATED_ACCOUNT_SUSPENDED`	このビジネスプロフィールに関連付けられた Google アカウントは、良好な状態ではありません。このアカウントに関連付けられたビジネスプロフィールは停止されています。
`BUSINESS_INELIGIBLE`	お客様のビジネスはビジネスプロフィールの掲載対象として適格ではありません。
`OWNERSHIP_REVOKED`	このビジネスプロフィールは、別の Google アカウントによって申請されています。このプロフィールは管理できなくなりました。
`LOCATION_SUSPENDED`	このビジネスプロフィールは停止されています。
`LOCATION_DISABLED`	このビジネスプロフィールは無効になっています。
`LOCATION_VERIFICATION_REQUIRED`	このビジネスプロフィールのオーナー確認は行われていません。
`PO_BOX`	ビジネスの住所に私書箱は使用できないため、ビジネスプロフィールは停止されました。
`GOOGLE_PAY_SUSPENSION`	お支払いプロファイルに関連付けられたビジネスプロフィールは停止されています。
`EDITING_RESTRICTION`	このビジネスプロフィールは現在、一般公開の更新を受け取ることが制限されています。ポリシーに違反するコンテンツが増えるのを防ぐため、この場所の編集は無効になっています。
`ILLEGAL_BUSINESS_HOURS_EDIT`	この業種では営業時間を編集できません。
`FAKE_ENGAGEMENT`	虚偽のエンゲージメントに関する Google のポリシーに違反するコンテンツは許可されません。虚偽のエンゲージメントには、報酬に基づくコンテンツ、場所の評価を操作することを意図したコンテンツ、実体験に基づいていないコンテンツなどがあります。
`ADULT_THEMED`	アダルト向けコンテンツに関する Google のポリシーに違反するコンテンツは許可されません。アダルト向けコンテンツには、露骨でない性的なコンテンツとその他のアダルトコンテンツの両方が含まれます。
`SEXUALLY_EXPLICIT`	性的描写が露骨なコンテンツに関する Google のポリシーに違反するコンテンツは許可されません。性的描写が露骨なコンテンツには、性器の露出、および性行為の描写や記述が含まれます。
`ADVERTISING_AND_SOLICITATION`	宣伝または勧誘に関する Google のポリシーに違反するコンテンツは許可されません。宣伝と勧誘には、営利目的のコンテンツや、利益と引き換えに投稿されるコンテンツが含まれます。
`DANGEROUS`	危険なコンテンツに関する Google のポリシーに違反するコンテンツは許可されません。危険なコンテンツとは、有害な行為を奨励、促進、または助長するコンテンツのことです。
`GIBBERISH_AND_REPETITIVE`	不明確なコンテンツや繰り返し投稿されたコンテンツに関する Google のポリシーに違反するコンテンツは許可されません。不明確なコンテンツや繰り返し投稿されたコンテンツがあると、Google がユーザーに提供する有益な情報の割合が低下するためです。
`REPETITIVE`	繰り返し投稿されたコンテンツに関する Google のポリシーに違反するコンテンツは許可されません。繰り返し投稿されたコンテンツには、1 つ以上のアカウントによって複数回追加された同一または類似のコンテンツが含まれます。
`UNCLEAR`	不明確なコンテンツに関する Google のポリシーに違反しているコンテンツは許可されません。不明確なコンテンツには、文字のランダムな羅列やその他の意味を持たないコンテンツが含まれます。
`ILLEGAL`	違法なコンテンツに関する Google のポリシーに違反するコンテンツは許可されません。
`OFF_TOPIC`	関連性のないコンテンツに関する Google のポリシーに違反するコンテンツは許可されません。関連性のないコンテンツには、一般的、政治的、社会的な論評や個人的な不満が含まれます。
`OFFENSIVE`	不適切なコンテンツに関する Google のポリシーに違反するコンテンツは許可されません。不適切なコンテンツとは、他者に強烈な怒り、侮辱、または冒とくの感情をかなり引き起こす可能性のあるコンテンツのことです。
`VIOLENCE_AND_GORE`	暴力的または残虐なコンテンツに関するポリシーに違反するコンテンツは許可されません。暴力的または残虐なコンテンツには、人または動物の生死にかかわる危険な内容で、暴力行為、流血、身体の部位、臓器の生々しい動きを表現しているコンテンツが含まれます。
`CHILD_SAFETY`	子供の安全に関する Google のポリシーに違反するコンテンツは許可されません。こうしたコンテンツには、子供を危険にさらしたり、子供を搾取、虐待したり、Google サービスを利用して子供を危険にさらしたりする内容のコンテンツが含まれます。
`HARASSMENT`	ハラスメントに関する Google のポリシーに違反するコンテンツは許可されません。これには、誰かをいじめる、脅迫する、性的対象として見る、または誰かに身の危険を感じさせるコンテンツが含まれます。
`HATE_SPEECH`	ヘイトスピーチに関する Google のポリシーに違反するコンテンツは許可されません。ヘイトスピーチには、暴力、差別、誹謗を助長または容認したり、守られるべき特性または構造的な差別や排斥に結び付く他の特性に基づいて憎悪を煽ったりする行為が含まれます。
`IMPERSONATION`	なりすましに関する Google のポリシーに違反するコンテンツは許可されません。なりすましには、他者を欺いたり不正な利益を得たりする目的で、別人になりすます行為が含まれます。
`MISINFORMATION`	誤った情報に関する Google のポリシーに違反するコンテンツは許可されません。誤った情報には、個人、企業または社会に対して大きな危害をもたらす可能性がある、虚偽情報や不正確な情報が含まれます。
`MISREPRESENTATION`	不実表示に関する Google のポリシーに違反するコンテンツは許可されません。不実表示には、不正な利益を得る目的で使われる、誤解を招く表現や省略が含まれます。
`OBSCENITY_AND_PROFANITY`	わいせつまたは冒とく的な表現に関する Google のポリシーに違反するコンテンツは許可されません。わいせつおよび冒とく的な表現のコンテンツには、地域において社会的に不適切または下品であると見なされる言葉やジェスチャーが含まれます。
`PERSONAL_INFO`	個人情報に関する Google のポリシーに違反するコンテンツは許可されません。個人情報には、クレジットカード情報や医療記録、政府発行の身分証明書など、ご自身や他人の個人情報や機密情報が含まれます。
`REGULATED_GOODS_AND_SERVICES`	規制対象の商品やサービスに関する Google のポリシーに違反するコンテンツは許可されません。こうしたコンテンツには、各地域で規制の対象となる商品やサービスの販売を促すフレーズや特典も含まれます。
`GENERIC_VANDALISM`	不適切なコンテンツまたは質の低いコンテンツに関する Google のポリシーに違反しているコンテンツは許可されません。
`GENERIC_FRAUD`	詐欺的なコンテンツと虚偽の振る舞いに関する Google のポリシーに違反しているコンテンツは許可されません。詐欺的なコンテンツとは、故意に他者を欺いているコンテンツを指します。
`PHOTOS_AND_VIDEOS_CRITERIA`	写真と動画に関する条件を満たしていないコンテンツは許可されません。
`MODERATION_ERROR`	コンテンツの処理中にエラーが発生しました。
`PRIVACY`	Google マップユーザーの投稿コンテンツに関するプライバシーポリシーに違反するコンテンツは許可されません。
`GENERIC_VIOLATION`	お客様のコンテンツは Google のポリシーに違反しているため、許可されません。
`GENERIC_QUALITY`	質の低いコンテンツに関する Google のポリシーに違反しているコンテンツは許可されません。
`IDENTITY_CHANGE`	お客様が行った変更は、作成されたビジネスと大きく異なります。これはポリシー違反に該当します。
`GEOGRAPHIC_LOCATION_CHANGE`	ビジネスの物理的な地理的位置（住所または緯度/経度）が、プロフィールの作成時から大幅に変更されていることを示します。

州

クチコミへの返信の審査状態を表します。

列挙型
`REVIEW_REPLY_STATE_UNSPECIFIED`	状態が指定されていないことを示します。
`PENDING`	返信が審査待ちであることを示します。
`REJECTED`	返信が拒否されたことを示します。
`APPROVED`	返信が承認されたことを示します。

辛さ

料理の辛さのレベル。

列挙型
`SPICINESS_UNSPECIFIED`	レベルが指定されていません
`MILD`	マイルドな辛さの表記。
`MEDIUM`	中辛の表記。
`HOT`	辛さの度合い。最も辛いレベル。

StartUploadMediaItemDataRequest

Media.StartUploadMediaItemData に対するリクエストメッセージです。

フィールド

parent

string

このメディアアイテムを追加するビジネスのリソース名です。

TimeInterval

時間間隔です（開始と終了の時間を含む）。有効にするには、すべてのフィールドを含める必要があります。

フィールド
`start_date`	`Date` この期間の開始日。
`start_time`	`TimeOfDay` この期間の開始時間。
`end_date`	`Date` この期間の終了日。
`end_time`	`TimeOfDay` この期間の終了時間。

UpdateFoodMenusRequest

FoodMenu.UpdateFoodMenus に対するリクエストメッセージ

フィールド

food_menus

FoodMenus

必須。更新されたフードメニューの情報。メニューセクションなしで更新すると、メニューの設定を解除できます。

update_mask

省略可。更新するフィールドです。マスクが指定されていない場合は、完全な更新として処理され、すべてのフィールドは渡された値に設定されます。リクエストに含まれる未設定の空のフィールドもこの対象となる場合があります。繰り返しフィールドのアイテムを個別に更新することはできません。注: FoodMenus の「name」は更新できないリソース識別子です。

UpdateLocalPostRequest

UpdateLocalPost に対するリクエストメッセージです。

フィールド

name

string

更新するローカル投稿の名前。

local_post

LocalPost

更新されたローカル投稿に関する情報です。

update_mask

更新するフィールドです。マスクで更新されている各フィールドを指定する必要があります。

UpdateMediaItemRequest

Media.UpdateMediaItem に対するリクエストメッセージです。

フィールド

name

string

更新するメディアアイテムの名前。

media_item

更新するメディアアイテム。

更新できるのは、カテゴリまたは価格表アイテムの ID のみです。

update_mask