Package google.mybusiness.businessinformation.v1

索引

AttributesService

クライアントが指定されたビジネスの属性を検索、更新できるようにします。

GetAttributes

rpc GetAttributes(GetAttributesRequest) returns (Attributes)

指定したビジネスに設定されているすべての属性を検索します。

認可スコープ

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

  • https://www.googleapis.com/auth/business.manage

詳細については、OAuth 2.0 の概要をご覧ください。

GetGoogleUpdatedAttributes

rpc GetGoogleUpdatedAttributes(GetGoogleUpdatedAttributesRequest) returns (Attributes)

指定したビジネスの Google によって更新されたバージョンを取得します。

認可スコープ

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

  • https://www.googleapis.com/auth/business.manage

詳細については、OAuth 2.0 の概要をご覧ください。

ListAttributeMetadata

rpc ListAttributeMetadata(ListAttributeMetadataRequest) returns (ListAttributeMetadataResponse)

指定したメインカテゴリと国のビジネスで使用可能な属性のリストを返します。

認可スコープ

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

  • https://www.googleapis.com/auth/business.manage

詳細については、OAuth 2.0 の概要をご覧ください。

UpdateAttributes

rpc UpdateAttributes(UpdateAttributesRequest) returns (Attributes)

指定したビジネスの属性を更新します。

認可スコープ

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

  • https://www.googleapis.com/auth/business.manage

詳細については、OAuth 2.0 の概要をご覧ください。

CategoriesService

この API は、Google でサポートされているビジネス拠点のカテゴリに関する情報を提供します。詳しくは、こちらの記事(https://support.google.com/business/answer/3038177)のカテゴリに関するセクションをご覧ください。

BatchGetCategories

rpc BatchGetCategories(BatchGetCategoriesRequest) returns (BatchGetCategoriesResponse)

指定された言語と GConcept ID に対応するビジネス カテゴリのリストを返します。

認可スコープ

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

  • https://www.googleapis.com/auth/business.manage

詳細については、OAuth 2.0 の概要をご覧ください。

ListCategories

rpc ListCategories(ListCategoriesRequest) returns (ListCategoriesResponse)

業種のリストを返します。検索はカテゴリ名と一致しますが、カテゴリ ID とは一致しません。

検索ではカテゴリ名の前のみが一致します(つまり、「食べ物」の場合は「フードコート」の場合は返されませんが、「ファスト フード店」の場合は返されません)。

認可スコープ

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

  • https://www.googleapis.com/auth/business.manage

詳細については、OAuth 2.0 の概要をご覧ください。

チェーン

チェーン ビジネスに関する情報を検索するサービス。

GetChain

rpc GetChain(GetChainRequest) returns (Chain)

指定されたチェーンを取得します。チェーンが存在しない場合は NOT_FOUND を返します。

認可スコープ

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

  • https://www.googleapis.com/auth/business.manage

詳細については、OAuth 2.0 の概要をご覧ください。

SearchChains

rpc SearchChains(SearchChainsRequest) returns (SearchChainsResponse)

チェーン名に基づいてチェーンを検索します。

認可スコープ

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

  • https://www.googleapis.com/auth/business.manage

詳細については、OAuth 2.0 の概要をご覧ください。

GoogleLocations

この API を使用すると、GoogleLocation へのアクセスと検索が可能になります。

SearchGoogleLocations

rpc SearchGoogleLocations(SearchGoogleLocationsRequest) returns (SearchGoogleLocationsResponse)

指定したリクエストに一致する可能性のあるすべてのビジネスを検索します。

認可スコープ

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

  • https://www.googleapis.com/auth/business.manage

詳細については、OAuth 2.0 の概要をご覧ください。

場所

この API を使用すると、Google でビジネス情報を管理できます。

CreateLocation

rpc CreateLocation(CreateLocationRequest) returns (Location)

ログインしているユーザーが所有する新しいビジネスを作成します。

認可スコープ

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

  • https://www.googleapis.com/auth/business.manage

詳細については、OAuth 2.0 の概要をご覧ください。

DeleteLocation

rpc DeleteLocation(DeleteLocationRequest) returns (Empty)

ビジネスを削除します。

API では削除できないビジネス情報が google.mybusiness.businessinformation.v1.LocationState で削除としてマークされている場合は、Google ビジネス プロフィールのウェブサイトを使用してください。

認可スコープ

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

  • https://www.googleapis.com/auth/business.manage

詳細については、OAuth 2.0 の概要をご覧ください。

GetGoogleUpdatedLocation

rpc GetGoogleUpdatedLocation(GetGoogleUpdatedLocationRequest) returns (GoogleUpdatedLocation)

指定したビジネスの Google によって更新されたバージョンを取得します。

認可スコープ

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

  • https://www.googleapis.com/auth/business.manage

詳細については、OAuth 2.0 の概要をご覧ください。

GetLocation

rpc GetLocation(GetLocationRequest) returns (Location)

指定したビジネスを返します。

認可スコープ

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

  • https://www.googleapis.com/auth/business.manage

詳細については、OAuth 2.0 の概要をご覧ください。

ListLocations

rpc ListLocations(ListLocationsRequest) returns (ListLocationsResponse)

指定したアカウントのビジネスを一覧表示します。

認可スコープ

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

  • https://www.googleapis.com/auth/business.manage

詳細については、OAuth 2.0 の概要をご覧ください。

UpdateLocation

rpc UpdateLocation(UpdateLocationRequest) returns (Location)

指定したビジネスを更新します。

認可スコープ

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

  • https://www.googleapis.com/auth/business.manage

詳細については、OAuth 2.0 の概要をご覧ください。

AdWordsLocationExtensions

AdWords に表示される追加情報。

フィールド
ad_phone

string

必須。ビジネスのメインの電話番号の代わりに AdWords の住所表示オプションに表示される予備の電話番号です。

属性

ビジネスの属性です。属性は、ビジネスに関する追加情報を提供します。ビジネスに設定できる属性は、そのビジネスのプロパティ(カテゴリなど)によって異なります。使用可能な属性は Google によって決定され、API の変更なしに追加、削除される場合があります。

フィールド
name

string

必須。この属性のリソース名。

value_type

AttributeValueType

出力のみ。この属性に含まれる値の型です。これを使用して、値の解釈方法を決定する必要があります。

values[]

Value

この属性の値。提供される値の型は、その属性に想定されるものと一致する必要があります。複数の属性値を指定することができる繰り返しフィールドです。属性型がサポートできる値は 1 つのみです。

repeated_enum_value

RepeatedEnumAttributeValue

属性値の型が REPEATED_ENUM の場合、このフィールドには属性値が含まれ、その他の値のフィールドは空にする必要があります。

uri_values[]

UriAttributeValue

属性値のタイプが URL の場合、このフィールドにはこの属性の値が含まれ、その他の値のフィールドは空にする必要があります。

AttributeMetadata

属性のメタデータ。ローカライズされた名前や関連属性をグループ化するための見出しなど、属性の表示情報が含まれます。

フィールド
parent

string

属性の一意の識別子。

value_type

AttributeValueType

属性の値の型。設定および取得する値は、次のタイプにする必要があります。

display_name

string

この属性のローカライズされた表示名(利用可能な場合)。それ以外の場合は、英語の表示名。

group_display_name

string

この属性を含むグループのローカライズされた表示名(利用可能な場合)。それ以外の場合は、英語のグループ名。関連属性がグループにまとめられ、ここに示す見出しの下にまとめて表示されます。

repeatable

bool

true の場合、属性で複数の値がサポートされます。false の場合、値を 1 つだけ指定する必要があります。

value_metadata[]

AttributeValueMetadata

一部の属性タイプ(列挙型など)については、サポートされている値と、それらの値に対応する表示名のリストが提供されます。

deprecated

bool

true の場合、属性は非推奨であるため、使用しないでください。非推奨の場合、この属性を更新してもエラーにはなりませんが、更新は保存されません。この属性は、サポートが終了した後のある時点で完全に削除され、エラーになります。

AttributeValueMetadata

サポートされている属性値のメタデータ。

フィールド
value

Value

属性値。

display_name

string

この値の表示名。ローカライズ可能な場合はローカライズされます。それ以外の場合は英語です。値の表示名は、属性の表示名と一緒に使用することが意図されています。

たとえば、「Wi-Fi」列挙型属性には、有料 Wi-Fi を表す「有料」を含めることができます。

AttributeValueType

属性の値の型。

列挙型
ATTRIBUTE_VALUE_TYPE_UNSPECIFIED 指定されていません。
BOOL この属性の値はブール値です。
ENUM この属性には、使用可能な値を示した既定の一覧があります。この属性のメタデータでは、これらの値が一覧表示されます。
URL この属性の値は URL です。
REPEATED_ENUM この属性値は、明示的に設定または設定解除できる複数の有効な値を含む列挙型です。

属性

指定されたビジネスのすべての属性を格納するコンテナ。

フィールド
name

string

必須。このビジネスの Google 識別子(locations/{location_id}/attributes の形式)。

attributes[]

Attribute

更新が必要な属性のコレクション。

BatchGetCategoriesRequest

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

フィールド
names[]

string

必須。少なくとも 1 つの名前を設定する必要があります。ローカライズされたカテゴリ名を返す GConcept ID です。複数のカテゴリの詳細を返すには、リクエストでこのパラメータを繰り返します。

language_code

string

必須。カテゴリ名を返す言語の BCP 47 コードです。

region_code

string

(省略可)標準以外の言語の推定に使用される ISO 3166-1 alpha-2 の国コード。

view

CategoryView

必須。レスポンスでカテゴリ リソースのどの部分を返すかを指定します。

BatchGetCategoriesResponse

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

フィールド
categories[]

Category

リクエストで指定された GConcept ID に一致するカテゴリ。リクエスト内のカテゴリ ID と同じ順序ではありません。

BusinessHours

ビジネスが営業している期間を表します。[TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod] インスタンスのコレクションを保持します。

フィールド
periods[]

TimePeriod

必須。ビジネスが営業している時間のコレクションです。各期間は、1 週間のうちビジネスが営業している時間帯を表します。

Categories

ビジネスを表すカテゴリのコレクション。更新時には、両方のフィールドを設定する必要があります。更新マスクを使用してメイン カテゴリまたは追加カテゴリを個別に更新することは禁止されています。

フィールド
primary_category

Category

必須。このビジネスの中核事業を最もよく表すカテゴリ。

additional_categories[]

Category

(省略可)ビジネスを説明する追加のカテゴリ。カテゴリを選択すると、そのサービスを探しているユーザーに見つけてもらいやすくなります。ビジネス情報を正確かつ最新の状態に保つため、中核事業を表すカテゴリはできるだけ少なくします。できるだけ具体的で、なおかつ中心となる事業内容を示すカテゴリを選択します。

カテゴリ

カテゴリは業種を表すもので、事業内容を表すものではありません。有効なカテゴリ ID と、人が読める形式の名前へのマッピングについては、categories.list をご覧ください。

フィールド
name

string

必須。このカテゴリの固定 ID(Google 提供)です。ビジネスの作成時または更新時にカテゴリを変更する場合は、値を指定する必要があります。

display_name

string

出力のみ。人間が読める形式のカテゴリ名です。ビジネスの読み取り時に設定されます。場所を変更する場合は、category_id を設定する必要があります。

service_types[]

ServiceType

出力のみ。この業種で利用できるすべてのサービスタイプのリスト。

more_hours_types[]

MoreHoursType

出力のみ。この業種で利用可能なその他の営業時間タイプです。

CategoryView

サーバーから返されるデータの量の制限に役立つ列挙型。

列挙型
CATEGORY_VIEW_UNSPECIFIED 指定しません。CATEGORY_METADATA_ONLY と同じです。
BASIC サーバー レスポンスには、カテゴリ フィールド display_name、category_id、language_code のみが含まれます。サービスタイプのメタデータに関連するフィールドは省略されます。
FULL レスポンス内のすべてのフィールドを返します。

チェーン

チェーンとは、ビジネス拠点をリンクできるブランドです。

フィールド
name

string

必須。チェーンのリソース名(chains/{chain_id} 形式)。

chain_names[]

ChainName

チェーンの名前。

websites[]

ChainUri

チェーンのウェブサイト。

location_count

int32

このチェーンに含まれるビジネスの数です。

ChainName

チェーンの表示時に使用する名前。

フィールド
display_name

string

このチェーンの表示名。

language_code

string

名前の言語の BCP 47 コード。

ChainUri

チェーンの表示時に使用する URL。

フィールド
uri

string

このチェーンの URI。

CreateLocationRequest

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

フィールド
parent

string

必須。このビジネスを作成するアカウントの名前。

location

Location

必須。新しい位置情報メタデータ。

validate_only

bool

(省略可)true の場合、ビジネスが実際に作成されることなく、リクエストの検証のみが行われます。

request_id

string

(省略可)重複するリクエストを検出するための、サーバーの一意のリクエスト ID。UUID を使用することをおすすめします。最大長は 50 文字です。

DeleteLocationRequest

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

フィールド
name

string

必須。削除するビジネスの名前。

ErrorCode

API から返されるすべてのエラーコード。

列挙型
ERROR_CODE_UNSPECIFIED エラーコードがありません。
INVALID_ATTRIBUTE_NAME 指定した属性の中に、このビジネスに適用できないものがあります。このビジネスに適用されるのは、ListAttributeMetadata レスポンスで返された属性のみです。問題のある属性名はすべて、metadata の下の attribute_names キーで返されます。
ASSOCIATE_OPERATION_ON_VERIFIED_LOCATION クライアントがオーナー確認済みステータスのビジネスの関連付けまたは解除を試みたときに返されます。
ASSOCIATE_LOCATION_INVALID_PLACE_ID associateLocation リクエストで指定された place_id はビジネスと一致していないか、無効です。設定されている place_id が、SearchGoogleLocations レスポンスで返される ID のいずれかと一致することを確認します。
LAT_LNG_UPDATES_NOT_PERMITTED このプロジェクトでは、ロケーションの緯度/経度フィールドを更新できません。緯度/経度は、UI のピンドロップ機能を使用して更新するか、住所を Google に提供できます。
PO_BOX_IN_ADDRESS_NOT_ALLOWED 住所に私書箱は使用できません。メタデータキーには「field_mask」が含まれます。
BLOCKED_REGION Google には、遵守する義務がある国際的制裁措置のため、この地域のビジネスを許可することはできません。メタデータキーには「field_maks」などがあります。
MISSING_BOTH_PHONE_AND_WEBSITE CUSTOMER_LOCATION_ONLY のビジネスの場合、電話番号またはウェブサイトのいずれかが必要です。メタデータキーには「field_mask」が含まれます。
MISSING_STOREFRONT_ADDRESS_OR_SAB すべてのビジネス拠点に、少なくとも店舗の住所かサービス提供地域が必要です。メタデータキーには「field_mask」が含まれます。
LAT_LNG_TOO_FAR_FROM_ADDRESS 緯度と経度と住所のペアが離れすぎています。メタデータキーには「field_mask」が含まれます。
LAT_LNG_REQUIRED 非推奨。PIN_DROP_REQUIRED に置き換えられます。指定された住所が見つかりません。緯度と経度を入力してください。メタデータキーには「field_mask」が含まれます。
INVALID_CHARACTERS 無効な文字が見つかりました。メタデータキーには「field_mask」と「invalid_characters」があります。
FORBIDDEN_WORDS 使用できない単語が見つかりました。メタデータキーには「field_mask」と「forbidden_words」があります。
INVALID_INTERCHANGE_CHARACTERS 無効な文字が見つかりました。メタデータキーには「field_mask」が含まれます。
FIELDS_REQUIRED_FOR_CATEGORY このカテゴリのビジネスには追加のフィールドが必要です。メタデータキーには、「field_mask」、「value」、「fields_required」などがあります。
STOREFRONT_REQUIRED_FOR_CATEGORY お客様の業種には、ユーザーが来店できる実店舗が必要です。メタデータキーには「field_mask」が含まれます。
ADDRESS_MISSING_REGION_CODE 住所に必須の region_code が指定されていません。メタデータキーには「field_mask」が含まれます。
ADDRESS_EDIT_CHANGES_COUNTRY 住所を別の国に移動することはできません。メタデータキーには「field_mask」が含まれます。
SPECIAL_HOURS_SET_WITHOUT_REGULAR_HOURS 特別営業時間を指定できるのは、その場所に通常の営業時間がある場合のみです。メタデータが空です。
INVALID_TIME_SCHEDULE タイム スケジュールが無効です。重複しているか、終了時間が開始時間より前になっています。メタデータキーには「field_mask」が含まれます。
INVALID_HOURS_VALUE 時間の形式または値が無効です。メタデータキーには「field_mask」が含まれます。
OVERLAPPED_SPECIAL_HOURS Special_hours を重複させることはできません。メタデータキーには「field_mask」が含まれます。
INCOMPATIBLE_MORE_HOURS_TYPE_FOR_CATEGORY お客様のビジネスのメインカテゴリは、この営業時間タイプに対応していません。メタデータキーには「field_mask」と「compatible_hours_type」があります。
DUPLICATE_CHILDREN_LOCATIONS interaction_data 内の child_locations が重複しています。メタデータキーには「field_mask」が含まれます。
INCOMPATIBLE_SERVICE_AREA_AND_CATEGORY 非店舗型ビジネスには、選択されたメインカテゴリを含めることはできません。メタデータキーには「field_mask」が含まれます。
INVALID_SERVICE_AREA_PLACE_ID service_area の place_id が無効です。メタデータキーには「field_mask」と「place_id」があります。
INVALID_AREA_TYPE_FOR_SERVICE_AREA service_area のエリアタイプが無効です。メタデータキーには「field_mask」と「place_id」があります。
OPENING_DATE_TOO_FAR_IN_THE_FUTURE 開業日として 1 年以内の日付を入力してください。メタデータキーには「field_mask」が含まれます。
OPENING_DATE_MISSING_YEAR_OR_MONTH 開業日には年または月を指定する必要があります。メタデータキーには「field_mask」が含まれます。
OPENING_DATE_BEFORE_1AD 開業日は西暦 1 年より前の日付にできません。メタデータキーには「field_mask」が含まれます。
TOO_MANY_ENTRIES フィールドのエントリが多すぎます。メタデータキーには「field_mask」と「max_count」があります。
INVALID_PHONE_NUMBER 入力された電話番号を認識できません。メタデータキーには「field_mask」と「value」があります。
INVALID_PHONE_NUMBER_FOR_REGION この地域の電話番号が無効です。メタデータキーには「field_mask」と「value」があります。
MISSING_PRIMARY_PHONE_NUMBER メインの電話番号が入力されていません。メタデータキーには「field_mask」が含まれます。
THROTTLED 現在、このフィールドを更新できません。メタデータキーには「field_mask」と「value」があります。
UNSUPPORTED_POINT_RADIUS_SERVICE_AREA 半径を指定したサービス提供地域のサポートは終了しました。メタデータキーには「field_mask」が含まれます。
INVALID_CATEGORY カテゴリ ID が無効です。メタデータキーには「field_mask」と「value」があります。
CANNOT_REOPEN ビジネスを再開することはできません。メタデータキーには「field_mask」が含まれます。
INVALID_BUSINESS_OPENING_DATE ビジネスの開業日が無効です。メタデータキーには「field_mask」が含まれます。
INVALID_LATLNG latlng が無効です。メタデータキーには「field_mask」が含まれます。
PROFILE_DESCRIPTION_CONTAINS_URL ビジネスの説明に URL を含めることはできません。メタデータキーには「field_mask」が含まれます。
LODGING_CANNOT_EDIT_PROFILE_DESCRIPTION 宿泊施設のプロフィールの説明は編集できません。メタデータキーには「field_mask」が含まれます。
INVALID_URL リンクが無効です。メタデータキーには「field_mask」が含まれます。
INVALID_ADDRESS 無効なアドレスです。メタデータキーには「field_mask」が含まれます。
PARENT_CHAIN_CANNOT_BE_THE_LOCATION_ITSELF ParentChain にビジネス自体を指定することはできません。メタデータキーには「field_mask」と「value」があります。
RELATION_CANNOT_BE_THE_LOCATION_ITSELF リレーションをビジネス自体にすることはできません。メタデータキーには「field_mask」と「value」があります。
MISSING_ADDRESS_COMPONENTS 住所コンポーネントの値が指定されていません。メタデータキーには「field_mask」が含まれます。
READ_ONLY_ADDRESS_COMPONENTS 読み取り専用の住所コンポーネントは編集できません。メタデータキーには「field_mask」が含まれます。
STRING_TOO_LONG 文字列が長すぎます。メタデータキーには「field_mask」と「max_length」があります。
STRING_TOO_SHORT 文字列が短すぎます。メタデータキーには「field_mask」と「min_length」があります。
REQUIRED_FIELD_MISSING_VALUE 必須項目に値がありません。メタデータキーには「field_mask」が含まれます。
ATTRIBUTE_PROVIDER_URL_NOT_ALLOWED プロバイダの URL を追加または編集することはできません。メタデータキーには「attribute_name」が含まれます。
ATTRIBUTE_INVALID_ENUM_VALUE enum 属性が不明です。メタデータキーには「attribute_name」が含まれます。
ATTRIBUTE_NOT_AVAILABLE このロケーションではスケーラブルな属性が無効です。メタデータキーには「attribute_name」が含まれます。
ATTRIBUTE_CANNOT_BE_REPEATED 拡張可能属性は 1 回だけ指定します。メタデータキーには「attribute_name」が含まれます。
ATTRIBUTE_TYPE_NOT_COMPATIBLE_FOR_CATEGORY 拡張可能な属性は、ビジネスに設定されているカテゴリに対応していません。メタデータキーには「attribute_name」が含まれます。
ADDRESS_REMOVAL_NOT_ALLOWED お客様のビジネスでは住所の削除が許可されていません。メタデータキーには「field_mask」が含まれます。
AMBIGUOUS_TITLE 最適な名前が言語に対して不明確です。メタデータキーには「field_mask」が含まれます。
INVALID_CATEGORY_FOR_SAB 純粋な非店舗型ビジネスでは、gcid:establishment_poi のサブタイプである gcid を指定できません。メタデータキーには「field_mask」と「value」があります。
RELATION_ENDPOINTS_TOO_FAR リレーション エンドポイントが互いに離れすぎています。メタデータキーには「field_mask」と「value」があります。
INVALID_SERVICE_ITEM Structured_service_item も free_form_service_item も設定されていません。メタデータキーには「field_mask」が含まれます。
SERVICE_ITEM_LABEL_NO_DISPLAY_NAME ラベルに表示名がありません。メタデータキーには「field_mask」が含まれます。
SERVICE_ITEM_LABEL_DUPLICATE_DISPLAY_NAME 表示名がすべてのラベルで、すべての価格表で一意ではありません。メタデータキーには「field_mask」が含まれます。
SERVICE_ITEM_LABEL_INVALID_UTF8 ラベルに無効な UTF-8 記号が含まれています。メタデータキーには「field_mask」が含まれます。
FREE_FORM_SERVICE_ITEM_WITH_NO_CATEGORY_ID free_form_service_item に category_id フィールドがありません。メタデータキーには「field_mask」が含まれます。
FREE_FORM_SERVICE_ITEM_WITH_NO_LABEL free_form_service_item にラベルがありません。メタデータキーには「field_mask」が含まれます。
SERVICE_ITEM_WITH_NO_SERVICE_TYPE_ID Structured_service_item に service_type_id フィールドがありません。メタデータキーには「field_mask」が含まれます。
INVALID_LANGUAGE 言語コードが無効です。メタデータキーには「field_mask」が含まれます。
PRICE_CURRENCY_MISSING ISO 4217 通貨コードがありません。メタデータキーには「field_mask」が含まれます。
PRICE_CURRENCY_INVALID 指定した通貨コードは有効な ISO 4217 ではありません。メタデータキーには「field_mask」が含まれます。
SERVICE_TYPE_ID_DUPLICATE サービスタイプ ID がビジネス内で一意ではありません。メタデータキーには「field_mask」が含まれます。
PIN_DROP_REQUIRED 指定された住所が見つかりません。UI を使用してピンをドロップしてください。メタデータキーには「field_mask」が含まれます。
STALE_DATA 1 つ以上のアイテムが最近 Google によって更新されました。現在、「field」にあるデータを変更できるのは、このビジネスのオーナーのみです。business.google.com にアクセスしてください。メタデータキーには「field_mask」があります。
PHONE_NUMBER_EDITS_NOT_ALLOWED このビジネス情報の電話番号は無効になっており、編集できません。メタデータキーには「field_mask」が含まれます。
MULTIPLE_ORGANIZATIONALLY_PART_OF_RELATION 2 つの場所間の論理関係をモデル化する複数の関係(例: 支部、職場)が存在します。メタデータキーには「field_mask」と「value」があります。

GetAttributesRequest

AttributesService.GetAttributes のリクエスト。

フィールド
name

string

必須。このビジネスの Google 識別子(locations/{location_id}/attributes の形式)。

GetChainRequest

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

フィールド
name

string

必須。チェーンのリソース名(chains/{chain_place_id} 形式)。

GetGoogleUpdatedAttributesRequest

AttributesService.GetGoogleUpdatedAttributes のリクエスト。

フィールド
name

string

必須。このビジネスの Google 識別子(locations/{location_id}/attributes の形式)。

GetGoogleUpdatedLocationRequest

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

フィールド
name

string

必須。取得するビジネスの名前です。

read_mask

FieldMask

必須。マスクを読み取って、レスポンスで返されるフィールドを指定します。

GetLocationRequest

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

フィールド
name

string

必須。取得するビジネスの名前です。

read_mask

FieldMask

必須。マスクを読み取って、レスポンスで返されるフィールドを指定します。

GoogleLocation

Google に存在する Location を表します。ユーザーまたは他のユーザーによって申請されたビジネス、または申請が未申請の可能性があるビジネスです。

フィールド
name

string

この GoogleLocation のリソース名。形式は googleLocations/{googleLocationId} です。

location

Location

スパースに入力された Location 情報。このフィールドは、現在ユーザーが申請していない場合、CreateLocation で再利用できます。

request_admin_rights_uri

string

管理者権限のリクエスト UI にユーザーをリダイレクトする URL。このフィールドは、現在のユーザーを含むユーザーによってすでにビジネスが申請されている場合にのみ存在します。

GoogleUpdatedLocation

Google によって変更されたビジネスを表します。

フィールド
location

Location

このビジネスの Google によって更新されたバージョンです。

diff_mask

FieldMask

Google が更新されたフィールド。

pending_mask

FieldMask

まだマップと検索にプッシュされていない、保留中の編集があるフィールドです。

ラベル

価格表、セクション、アイテムの表示時に使用するラベル。

フィールド
display_name

string

必須。価格表、セクション、または商品アイテムの表示名です。

description

string

(省略可)価格表、セクション、または商品アイテムの説明です。

language_code

string

(省略可)これらの文字列に適用する BCP 47 言語コードです。言語ごとに設定できるラベルのセットは 1 つのみです。

ListAttributeMetadataRequest

AttributesService.ListAttributeMetadata のリクエスト。

フィールド
parent

string

使用可能な属性を検索するビジネスのリソース名。このフィールドが設定されている場合、category_name、region_code、language_code、show_all は必須ではないため、設定することはできません。

category_name

string

使用可能な属性を検索するメインカテゴリの固定の ID です。「カテゴリ/{category_id}」の形式で指定してください。

region_code

string

使用可能な属性を検索する ISO 3166-1 alpha-2 の国コードです。

language_code

string

属性表示名を取得する言語の BCP 47 コード。この言語を利用できない場合は、英語で表示されます。

show_all

bool

このフィールドが true に設定されている場合、利用可能なすべての属性のメタデータが返されます。親フィールドと category_name フィールドは無視されます。show_all が true に設定されている場合は language_code と region_code が必要です。

page_size

int32

1 ページあたりに含める属性数です。デフォルトは 200 で、最小値は 1 です。

page_token

string

指定すると、属性メタデータの次のページが取得されます。

ListAttributeMetadataResponse

AttributesService.ListAttributeMetadata に対するレスポンス。

フィールド
attribute_metadata[]

AttributeMetadata

使用可能な属性の属性メタデータのコレクションです。

next_page_token

string

属性数がリクエストしたページサイズを超えた場合、このフィールドには、後続の attributes.list の呼び出しで属性の次のページを取得するためのトークンが入力されます。取得する属性がそれ以上ない場合、このフィールドはレスポンスに含められません。

ListCategoriesRequest

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

フィールド
region_code

string

必須。ISO 3166-1 alpha-2 の国コード。

language_code

string

必須。言語の BCP 47 コード。

filter

string

(省略可)ユーザーのフィルタ文字列。サポートされているフィールドは displayName のみです。(例: filter=displayName=foo)。

page_size

int32

(省略可)1 ページあたりで取得するカテゴリの数。デフォルトは 100 で、最小値は 1、最大ページサイズは 100 です。

page_token

string

(省略可)指定すると、カテゴリの次のページが取得されます。

view

CategoryView

必須。レスポンスでカテゴリ リソースのどの部分を返すかを指定します。

ListCategoriesResponse

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

フィールド
categories[]

Category

リクエストされたパラメータに基づいて一致するカテゴリ。

next_page_token

string

カテゴリ数がリクエストしたページサイズを超えた場合、このフィールドには、後続の ListCategories の呼び出しでカテゴリの次のページを取得するためのトークンが入力されます。

ListLocationsRequest

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

フィールド
parent

string

必須。ビジネスを取得するアカウントの名前です。親の [Account] [Account] [google.mybusiness.accountmanagement.v1.Account] が [AccountType] [google.mybusiness.accountmanagement.v1.Account.AccountType] PERSONAL の場合は、アカウントで直接所有しているビジネスのみが返されます。それ以外の場合は、アカウントからアクセス可能なすべてのビジネス情報が、直接的または間接的に返されます。

page_size

int32

(省略可)1 ページあたりで取得するビジネス情報の数。設定しない場合、デフォルト値の 10 になります。最小値は 1、最大ページサイズは 100 です。

page_token

string

(省略可)指定すると、ビジネスの次の page が取得されます。前の ListLocations の呼び出しによって、リクエストしたページサイズを上回る数の場所があった場合、ページトークンが返されます。

filter

string

(省略可)返されるビジネス情報を限定するフィルタ。レスポンスには、フィルタに一致するエントリのみが含まれます。filter が空の場合、リクエストされたアカウントについて制約が適用され、すべてのビジネス(ページ分けされたもの)が取得されます。

有効なフィールドと使用例について詳しくは、位置情報の使用に関するガイドをご覧ください。

order_by

string

(省略可)リクエストの並べ替え順。複数のフィールドは、SQL 構文に従ってカンマで区切ってください。デフォルトの並べ替え順は昇順です。降順を指定するには、接尾辞「desc」を追加する必要があります。order_by の有効なフィールドは title と store_code です。例: 「title, store_code desc」、「title」、「store_code desc」

read_mask

FieldMask

必須。マスクを読み取って、レスポンスで返されるフィールドを指定します。

ListLocationsResponse

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

フィールド
locations[]

Location

ビジネス情報。

next_page_token

string

ビジネスの数がリクエストしたページサイズを超えた場合、このフィールドには、後続の ListLocations の呼び出しでビジネスの次のページを取得するためのトークンが入力されます。取得する場所がそれ以上ない場合、このフィールドはレスポンスに含められません。

total_size

int32

ページ分けに関係なく、リスト内のビジネスのおおよその数です。このフィールドは、filter がクエリ パラメータとして使用されている場合にのみ返されます。

ロケーション

ビジネスです。これらのフィールドの詳細についてはヘルプセンター記事をご覧ください。有効な業種の一覧については、カテゴリ エンドポイントをご覧ください。

フィールド
name

string

このビジネスの Google 識別子。locations/{location_id} の形式で指定します。

language_code

string

変更不可。ビジネスの言語。作成時に設定され、更新できません。

store_code

string

(省略可)このビジネスの外部識別子。アカウント内で一意である必要があります。これにより、ビジネスとご自身の記録が関連付けられます。

title

string

必須。店舗、ウェブサイト、事務用品で一貫して使用され、顧客に知られている実際のビジネス拠点名を反映させてください。関連性のある追加情報は、リソースの他のフィールド(例: AddressCategories)に含めることができます。名前に不要な情報を追加しないでください(たとえば、「Google Inc. - Mountain View 本社」よりも「Google」を優先してください)。マーケティングのキャッチフレーズ、店舗コード、特殊文字、営業時間や営業状況、電話番号、ウェブサイトの URL、サービスや商品の情報、所在地や住所、入居情報(例: 「東京都港区六本木 6 丁目 10 - 10 の六本木」)は含めないでください。

phone_numbers

PhoneNumbers

(省略可)ユーザーがビジネスに問い合わせる際に使用できる電話番号です。

categories

Categories

(省略可)ビジネスを表すさまざまなカテゴリ。

storefront_address

PostalAddress

(省略可)ビジネス拠点を表す正確な住所。遠隔地にある私書箱は使用できません。現時点では、アドレスに最大 5 つの address_lines 値を指定できます。このフィールドは、外観を持つビジネスでのみ設定する必要があります。このフィールドはタイプ CUSTOMER_LOCATION_ONLY のビジネスには設定できませんが、設定すると、指定した値はすべて破棄されます。

website_uri

string

(省略可)このビジネスの URL。可能であれば、すべての拠点やブランドに共通する一般的なウェブサイトや URL ではなく、このビジネス拠点専用の URL を使用してください。

regular_hours

BusinessHours

(省略可)ビジネスの営業時間。

special_hours

SpecialHours

(省略可)ビジネスの特別営業時間。祝休日の営業時間など、通常の営業時間外の時間が含まれます。これらの設定は通常の営業時間よりも優先されます。このフィールドに通常の営業時間を指定することはできません。

service_area

ServiceAreaBusiness

(省略可)非店舗型ビジネスとは、顧客のもとに出向いてサービスを提供するビジネスのことです。ビジネスが非店舗型ビジネスである場合、このフィールドはそのビジネスがサービスを提供する地域を表します。

labels[]

string

(省略可)ビジネスにタグを付けられるようにするための自由形式の文字列のコレクション。これらのラベルはユーザーには表示されず、自分だけが閲覧できます。ラベルあたり 1 ~ 255 文字にする必要があります。

ad_words_location_extensions

AdWordsLocationExtensions

(省略可)AdWords に表示される追加情報。

latlng

LatLng

(省略可)ユーザー指定の緯度と経度。ビジネスの作成時に、提供された住所のジオコード処理が行われた場合は無視されます。このフィールドは、作成時にユーザーが指定した latlng 値を受け入れるか、Google ビジネス プロフィールのウェブサイトから latlng 値が更新された場合に、get リクエストでのみ返されます。この項目は承認済みのクライアントだけが更新できます。

open_info

OpenInfo

(省略可)ビジネスが現在営業しているかどうかを示すフラグ。

metadata

Metadata

出力のみ。ユーザーが編集できない追加情報。

profile

Profile

(省略可)ご自身のビジネスについて自分の言葉で説明し、ビジネスや商品に関する独自のストーリーをユーザーと共有します。

このフィールドは、ホテル、モーテル、インなどの宿泊施設のカテゴリを除くすべてのカテゴリで必須です。

relationship_data

RelationshipData

(省略可)このビジネスに関連するすべてのビジネス拠点とチェーンです。

more_hours[]

MoreHours

(省略可)ビジネスの各部門や特定の顧客の営業時間の詳細。

service_items[]

ServiceItem

(省略可)販売者がサポートしているサービスの一覧。サービスには、カットや給湯器の設置などがあります。重複したサービス項目は自動的に削除されます。

メタデータ

ビジネスに関する、ユーザーが編集できない追加情報。

フィールド
has_google_updated

bool

出力のみ。このビジネスに関連付けられているプレイス ID に、クライアントによる更新または不承認が必要な更新があるかどうかを示します。このブール値が設定されている場合、getGoogleUpdated メソッドを呼び出して、検証が必要な情報を検索します。

has_pending_edits

bool

出力のみ。このビジネスのプロパティのいずれかが「編集内容が審査中」かどうかを表します。

can_delete

bool

出力のみ。API を使用してビジネスを削除できるかどうかを示します。

can_operate_local_post

bool

出力のみ。リスティングでローカル投稿を管理できるかどうかを示します。

can_modify_service_list

bool

出力のみ。リスティングがサービスリストを変更できるかどうかを示します。

can_have_food_menus

bool

出力のみ。リスティングがフードメニューの対象となるかどうかを示します。

can_operate_health_data

bool

出力のみ。ビジネスでヘルスデータを操作できるかどうかを示します。

can_operate_lodging_data

bool

出力のみ。ビジネスが宿泊施設データを操作できるかどうかを示します。

place_id

string

出力のみ。このビジネス情報が Google マップに表示されている場合、このフィールドにはそのビジネスのプレイス ID が入力されます。この ID はさまざまな Places API で使用できます。

このフィールドは、Create の呼び出し時に設定できますが、Update の呼び出し時には設定できません。

duplicate_location

string

出力のみ。このビジネスと重複しているビジネス リソースです。

maps_uri

string

出力のみ。マップ上のビジネスへのリンク。

new_review_uri

string

出力のみ。ユーザーがビジネスのクチコミを投稿できる Google 検索のページへのリンク。

can_have_business_calls

bool

出力のみ。リスティングがビジネス通話に対応しているかどうかを示します。

has_voice_of_merchant

bool

出力のみ。リスティングに Voice of Merchant が含まれているかどうかを示します。このブール値が false の場合は、locations.getVoiceOfMerchantState API を呼び出して、販売者様向けの Voice を利用できない理由の詳細を取得する必要があります。

MoreHours

ビジネスが特定のタイプのビジネスを営業している期間です。

フィールド
hours_type_id

string

必須。営業時間の種類。クライアントは、{#link businessCategories:BatchGet} を呼び出して、店舗のカテゴリでサポートされている営業時間のタイプを取得する必要があります。

periods[]

TimePeriod

必須。ビジネスが営業している時間のコレクションです。各期間は、1 週間のうちビジネスが営業している時間帯を表します。

MoreHoursType

通常の営業時間に加えて、ビジネスが提供できるその他の営業時間タイプ。

フィールド
hours_type_id

string

出力のみ。この営業時間タイプに対して Google が提供する固定 ID。

display_name

string

出力のみ。時間タイプの、人が読める形式の英語の表示名。

localized_display_name

string

出力のみ。時間タイプの、人が読める形式のローカライズされた表示名。

OpenInfo

ビジネスの営業状態に関する情報です。

フィールド
status

OpenForBusiness

必須。ビジネスが現在営業しているかどうかを表します。すべてのビジネスはデフォルトで営業中になります(休業中に変更された場合を除く)。

can_reopen

bool

出力のみ。このビジネスが営業再開の条件を満たしているかどうかを示します。

opening_date

Date

(省略可)ビジネスが開業した日付。正確な日付が不明な場合は、年月のみを指定できます。過去の日付または今後 1 年以内の日付を指定する必要があります。

OpenForBusiness

ビジネスのステータスを示します。

列挙型
OPEN_FOR_BUSINESS_UNSPECIFIED 指定されていません。
OPEN ビジネスが営業していることを表します。
CLOSED_PERMANENTLY ビジネスが閉業したことを表します。
CLOSED_TEMPORARILY ビジネスが臨時休業していることを示します。

PhoneNumbers

ビジネスの電話番号のコレクション。更新時には、両方のフィールドを設定する必要があります。クライアントは更新マスクを使用して、メインの電話番号または追加の電話番号だけを更新することはできません。国際電話の形式を使用することをおすすめします(例: +1 415 555 0132)。詳しくは、https://developers.google.com/style/phone-numbers#international-phone-numbers) をご覧ください。

フィールド
primary_phone

string

必須。個別のビジネス拠点に直接つながる電話番号を指定します。可能であれば、電話総合受付センターではなく、個々のお店の番号を使用します。

additional_phones[]

string

(省略可)電話番号に加えて、ビジネスの電話連絡先を最大 2 件登録できます(携帯電話でも固定電話でもかまいませんが、FAX 番号は指定できません)。

PlaceInfo

プレイス ID で表される地域を定義します。

フィールド
place_name

string

必須。場所のローカライズされた名前ですたとえば、Scottsdale, AZ のようにします。

place_id

string

必須。場所の ID です。リージョンに対応している必要があります。(https://developers.google.com/places/web-service/supported_types#table3)

プレイス

場所のセットで表される地域の和集合を定義します。

フィールド
place_infos[]

PlaceInfo

プレイス ID で表される地域です。場所は最大 20 か所に制限されています。

プロファイル

ビジネスのプロフィールに関するすべての情報です。

フィールド
description

string

必須。自分の言葉で場所の説明を記述し、他のユーザーは編集できないようにします。

RelationshipData

このページに関連するすべての親と子のビジネス情報。

フィールド
parent_location

RelevantLocation

このビジネスが関連付けられている親ビジネスです。

children_locations[]

RelevantLocation

このビジネスが関係する子ビジネスのリストです。

parent_chain

string

このビジネスが属しているチェーンのリソース名です。[チェーン ID を確認する方法] [Locations.SearchChains]

RelevantLocation

現在の場所に関連付けられている別のビジネスに関する情報。関係は DEPARTMENT_OF または INDEPENDENT_ESTABLISHMENT_OF のいずれかで、ここで指定するビジネスはビジネスの両側(親/子)に指定できます。

フィールド
place_id

string

必須。関係の反対側にあるビジネス拠点を placeID で指定します。

relation_type

RelationType

必須。関係のタイプ。

RelationType

指定する型の関係。

列挙型
RELATION_TYPE_UNSPECIFIED 未指定
DEPARTMENT_OF 2 つのビジネス拠点が同じ所在地で、同じブランド/経営陣/組織を共有しているが、営業時間や電話番号などの主要な属性が異なることを表します。たとえば、コストコ薬局はコストコ卸売部門の 1 つです。
INDEPENDENT_ESTABLISHMENT_IN これは、2 つのビジネス拠点が同じ物理的な拠点に同じ場所にあり、別々の会社(例: スーパーバックスのスターバックス、ショッピング モールのショップ)のものである場合を表します。

RepeatedEnumAttributeValue

value_type が REPEATED_ENUM である属性の値。これは、値 ID の 2 つのリストで構成されます。設定されている(true)ものと未設定(false)の ID です。存在しない値は不明と見なされます。少なくとも 1 つの値を指定する必要があります。

フィールド
set_values[]

string

設定されている列挙値。

unset_values[]

string

設定されていない列挙値です。

SearchChainsRequest

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

フィールド
chain_name

string

必須。名前でチェーンを検索します。完全一致/部分/ファジー/関連クエリがサポートされています。例: 「walmart」、「wal-mart」、「walmmmart」、「省尔玛」

page_size

int32

このクエリから返される、一致したチェーンの最大数です。デフォルト値は 10 です。指定できる最大値は 500 です。

SearchChainsResponse

Locations.SearchChains に対するレスポンス メッセージ。

フィールド
chains[]

Chain

SearchChainsRequest でクエリされた chain_display_name と一致するチェーン。一致するものがない場合、このフィールドは空になります。結果は関連性の高い順に一覧表示されます。

SearchGoogleLocationsRequest

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

フィールド
page_size

int32

返される一致の数。デフォルト値は 3、最大値は 10 です。さらにリクエストすると、レイテンシが増加する可能性があります。ページ分けはありません。

共用体フィールド search_query。検索クエリ。位置情報オブジェクトまたは文字列クエリで指定できます。search_query は次のいずれかになります。
location

Location

検索対象の場所。指定すると、指定した場所の詳細に一致する場所が検索されます。

query

string

検索するテキストクエリ。クエリ文字列から得られる検索結果は、正確な場所を指定する場合よりも精度は低くなりますが、完全一致しない一致の可能性は高くなります。

SearchGoogleLocationsResponse

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

フィールド
google_locations[]

GoogleLocation

指定されたリクエストに一致する可能性がある GoogleLocations のコレクション。精度が高い順に表示されます。

ServiceAreaBusiness

非店舗型ビジネスとは、顧客のもとに出向いてサービスを提供するビジネスのことです(鍵業者や配管業者など)。

フィールド
business_type

BusinessType

必須。非店舗型ビジネスの [type] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] を示します。

places

Places

そのビジネスがサービスを提供する地域を、場所のセットで定義します。

region_code

string

変更不可。この非店舗型ビジネスの拠点となる国/地域の CLDR 地域コード。詳細については、http://cldr.unicode.org/http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html をご覧ください。たとえば、スイスの場合は「CH」になります。

このフィールドは、CUSTOMER_LOCATION_ONLY のビジネスの場合は必須です。それ以外の場合は無視されます。

ここで指定する地域は、このビジネスがサービスを提供するエリアの地域とは異なる場合があります(非店舗型ビジネスなど)。

ビジネス拠点の作成後に確認が必要な場合は、オーナー確認用の住所が該当の地域内にある必要があります。また、ビジネス オーナーまたはその正式な代理人が、提供された確認用住所で郵便物を受け取ることができる必要があります

BusinessType

このビジネスが、顧客のもとに出向いてオンサイトのサービスのみを提供する(レッカー車など)か、住所とオンサイトの両方でサービスを提供する(ダイニング エリアを備えたピザ屋で、宅配もするピザ店など)かを示します。

列挙型
BUSINESS_TYPE_UNSPECIFIED 出力のみ。指定されていません。
CUSTOMER_LOCATION_ONLY ビジネス拠点がある住所ではなく、周辺地域でのみサービスを提供します。ビジネスを CUSTOMER_AND_BUSINESS_LOCATION から CUSTOMER_LOCATION_ONLY に更新する場合は、ビジネスの更新にフィールド マスク storefront_address を含めて、フィールドを空に設定する必要があります。
CUSTOMER_AND_BUSINESS_LOCATION ビジネスの住所とその周辺地域でサービスを提供します。

ServiceItem

1 つのサービス アイテムを説明するメッセージ。販売者が提供しているサービスの種類を表すために使用されます。たとえば、ヘアカットがサービスになりえます。

フィールド
price

Money

(省略可)サービス アイテムの金額を表します。価格を含める場合は、currency_code と単位を設定することをおすすめします。これはサービス アイテムの固定価格として扱われます。

共用体フィールド service_item_info。次のフィールドのいずれかを必ず設定する必要があります。service_item_info は次のいずれかになります。
structured_service_item

StructuredServiceItem

(省略可)このフィールドは、構造化データのデータの大文字 / 小文字に設定されます。

free_form_service_item

FreeFormServiceItem

(省略可)このフィールドは、自由形式のサービスデータのケースに設定されます。

FreeFormServiceItem

販売者が提供する自由形式のサービスを表します。これらのサービスは、ストラクチャ サービス データの一部として公開されません。販売者は、販売者向けのサーフェスでサービスの名前を手動で入力します。

フィールド
category

string

必須。このフィールドはカテゴリ名(カテゴリの固定 ID)を表します。categoryservice_type_id は、Category メッセージで指定される可能性がある組み合わせと一致する必要があります。

label

Label

必須。商品アイテムの言語タグを含むラベルです。アイテム名は半角 140 文字(全角 120 文字)、商品説明は半角 250 文字(全角 125 文字)以内にすることをおすすめします。このフィールドは、入力がカスタム サービス アイテムである場合にのみ設定する必要があります。標準化されたサービスタイプは、service_type_id で更新する必要があります。

StructuredServiceItem

販売者が提供する構造化されたサービスを表します。(例: toilet_installation)。

フィールド
service_type_id

string

必須。service_type_id フィールドは Google 提供の一意の ID で、ServiceType で確認できます。この情報は、BatchGetCategories RPC サービスによって提供されます。

description

string

(省略可)構造化されたサービス アイテムの説明。文字数制限は 300 文字です。

ServiceType

ビジネスが提供するサービスの種類を説明するメッセージ。

フィールド
service_type_id

string

出力のみ。このサービスタイプの不変の ID(Google 提供)です。

display_name

string

出力のみ。人が読める形式のサービスタイプの表示名。

SpecialHourPeriod

ビジネスの営業時間が通常の営業時間と異なる単一の期間を表します。特別営業時間が表す期間は 24 時間未満でなければなりません。open_timestart_date は、close_timeend_date より前の日付にする必要があります。close_timeend_date は、指定した start_date の翌日の午前 11 時 59 分まで延長できます。たとえば、次の入力は有効です。

start_date=2015-11-23, open_time=08:00, close_time=18:00
start_date=2015-11-23, end_date=2015-11-23, open_time=08:00,
close_time=18:00 start_date=2015-11-23, end_date=2015-11-24,
open_time=13:00, close_time=11:59

次の入力は無効です。

start_date=2015-11-23, open_time=13:00, close_time=11:59
start_date=2015-11-23, end_date=2015-11-24, open_time=13:00,
close_time=12:00 start_date=2015-11-23, end_date=2015-11-25,
open_time=08:00, close_time=18:00
フィールド
start_date

Date

必須。この特別営業時間が始まる日付です。

open_time

TimeOfDay

(省略可)有効な値は 00:00 ~ 24:00 で、24:00 は曜日フィールドで指定した日が終了する深夜 0 時を表します。closed が false の場合は指定する必要があります。

end_date

Date

(省略可)この特別営業時間が終了する日付です。end_date フィールドが設定されていない場合、デフォルトは start_date で指定された日付になります。設定する場合は、start_date と同じ日か翌日を指定する必要があります。

close_time

TimeOfDay

(省略可)有効な値は 00:00 ~ 24:00 で、24:00 は曜日フィールドで指定した日が終了する深夜 0 時を表します。closed が false の場合は指定する必要があります。

closed

bool

(省略可)true の場合、end_dateopen_timeclose_time は無視され、start_date で指定された日付は、ビジネスが終日休業する日として扱われます。

SpecialHours

ビジネスの営業時間が通常の営業時間と異なる一連の期間を表します。

フィールド
special_hour_periods[]

SpecialHourPeriod

必須。ビジネスの通常の時間帯に対する例外の一覧です。

TimePeriod

ビジネスが営業している期間を表します。指定した営業開始日時から始まり、指定した営業終了日時で終わります。営業終了時間は、営業開始時間の後、たとえば同じ日の後の時間か翌日に設定する必要があります。

フィールド
open_day

DayOfWeek

必須。この期間が始まる day of the week を示します。

open_time

TimeOfDay

必須。有効な値は 00:00 ~ 24:00 で、24:00 は曜日フィールドで指定した日が終了する深夜 0 時を表します。

close_day

DayOfWeek

必須。この期間が終了する day of the week を示します。

close_time

TimeOfDay

必須。有効な値は 00:00 ~ 24:00 で、24:00 は曜日フィールドで指定した日が終了する深夜 0 時を表します。

UpdateAttributesRequest

AttributesService.UpdateAttributes のリクエスト。

フィールド
attributes

Attributes

更新が必要な属性のコレクション。

attribute_mask

FieldMask

必須。更新する属性の属性名です。attributes/{attribute} で表されます。

更新: 更新する属性フィールドで指定されたすべての属性を attribute_mask で設定する必要があります。上記のリストで設定されているが attribute_mask に含まれていない属性は無視されます。

削除: 属性リストに一致するエントリがない属性を削除するには、attribute_mask でその属性を指定する必要があります。ビジネス情報に設定されている属性をすべて削除するには、そのビジネス情報に適用可能な属性をすべて検索し、属性フィールドを空にして attribute_mask に追加する必要があります。

UpdateLocationRequest

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

フィールド
location

Location

必須。更新されたビジネスに関する情報です。

update_mask

FieldMask

必須。更新するフィールドです。

validate_only

bool

(省略可)true の場合、ビジネスが実際に更新されることなく、リクエストの検証のみが行われます。このフィールドが設定されている場合、検証エラーがある場合にのみ返されます。エラーが見つからなかった場合、レスポンスは空になります。

UriAttributeValue

value_type が URL である属性の値。

フィールド
uri

string

必須。この属性に対して提案された URI 値。