REST Resource: accounts.locations

string

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

string

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

object (Category)

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

object (Category)

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

string

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

string

出力専用。人が読める形式のカテゴリ名。ビジネスを読み取るときに設定されます。ロケーションを変更する場合は、category_id を設定する必要があります。

object (ServiceType)

出力専用。この業種で利用可能なすべてのサービスタイプのリスト。

object (MoreHoursType)

出力専用。この業種で利用できるその他の営業時間タイプです。

string

出力専用。このサービスタイプの固定 ID（Google 提供）。

string

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

string

出力専用。この営業時間タイプに対して Google から提供される固定の ID。

string

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

string

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

integer

PostalAddress のスキーマ リビジョン。最新のリビジョンである 0 に設定する必要があります。

新しいリビジョンはすべて、古いリビジョンと下位互換性があることが必要です。

string

必須。住所の国 / 地域に対応する CLDR 地域コード。この値は推測されることはなく、正確な値が確保されるかどうかはユーザー次第です。詳しくは、https://cldr.unicode.org/ と https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html をご覧ください。例: スイスの場合は「CH」。

string

省略可。この住所の表記に使われている BCP-47 言語コード（わかっている場合）。多くの場合、これは入力フォームの UI 言語です。あるいは、住所の国や地域で使用されているいずれかの言語、またはそれらの言語を音訳したものと一致する場合もあります。これは特定の国で住所のフォーマットに影響する可能性がありますが、データの正確性にとっては重要でなく、検証やその他のフォーマット関連以外の操作には影響しません。

この値が不明な場合は省略してください（間違っている可能性があるデフォルトは指定しないでください）。

例: 「zh-Hant」、「ja」、「ja-Latn」、「en」。

string

省略可。住所の郵便番号。すべての国で郵便番号の使用や存在を必要としているわけではありませんが、使用されている場合は、住所の他の部分で追加の確認が行われることがあります（例: 米国での州 / 郵便番号の確認）。

string

省略可。追加の国固有の並べ替えコード。ほとんどの地域では、これは使用されていません。使用される場合、値は「CEDEX」のような文字列で、その後に必要に応じて数字を付けたもの（例: 「CEDEX 7」）や、数字だけのものがあります。たとえば、ジャマイカの「セクターコード」、マラウイの「配達区域インジケータ」、コートジボワールの「郵便局インジケータ」などです。

string

省略可。その国 / 地域の住所に使用される最上位の行政区域。たとえば、州、省、都道府県などがこれに該当します。特にスペインでは、これは自治州ではなく県になります（例: 「カタルーニャ」ではなく「バルセロナ」）。州や県などの行政区画が住所表記に使用されない国もあります。たとえば、スイスではこの項目を空のままにします。

string

省略可。通常は住所の市区町村の部分を指します。たとえば、米国の市、イタリアのコムーネ、英国の郵便町名などがこれに該当します。地域区分が適切に定義されていないところや、この構造にうまく適合しない地域では、locality を空のままにして addressLines を使用してください。

string

省略可。住所の市町村部分の下位の区画。たとえば、字、特別区、地区などがこれに該当します。

string

住所の下位部分を記述する非構造化の住所行。

addressLines の値は型情報を持たず、単一のフィールドに複数の値を含めることができるため（例: 「Austin, TX」）、行の順序が明確であることが重要です。住所行の順序は、その住所の国 / 地域の「封筒順」であることが必要です。これが一定でない可能性のある場所（日本など）では、address_language を使用して明示的に指定します（例: 順序が大区分から小区分の場合は「ja」、小区分から大区分の場合は「ja-Latn」または「en」）。このように、住所の最も詳細な部分の行を言語に基づいて選択できます。

住所の構造化表現として許容される最小限の形式は、regionCode を設定し、残りすべての情報を addressLines に格納するというものです。そのような住所を、ジオコーディングなしできわめて正確に近く書式設定することも可能ですが、住所の構成要素についての意味的な推論は、少なくとも部分的に解決されるまでは不可能です。

完全に構造化されていない住所を処理するには、（住所のどの部分が地域区分で、どの部分が行政区域であるかを推測するのではなく）regionCode と addressLines のみを含む住所を作成してからジオコーディングを行うことをおすすめします。

string

省略可。その住所で受け取る人。このフィールドには、場合によっては複数の情報を含めることができます。たとえば、「様方」情報が含まれる場合があります。

string

省略可。その住所にある組織の名前。

object (TimePeriod)

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

enum (DayOfWeek)

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

object (TimeOfDay)

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

enum (DayOfWeek)

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

object (TimeOfDay)

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

integer

時間（24 時間形式）。0～23 である必要があります。API ではビジネスの終了時間などのシナリオにおいて、値 "24:00:00" を許可することもできます。

integer

分。0～59 である必要があります。

integer

秒。通常、0～59 である必要があります。API がうるう秒を許可する場合、値 60 が許可されます。

integer

秒の小数部分（ナノ秒単位）。0～999,999,999 である必要があります。

object (SpecialHourPeriod)

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

object (Date)

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

object (TimeOfDay)

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

object (Date)

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

object (TimeOfDay)

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

boolean

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

integer

その日付の年。1～9999、または年のない日付を指定する場合は 0 にする必要があります。

integer

1 年の中の月。1～12、または月と日のない年を指定する場合は 0 にする必要があります。

integer

1 月の中の日付。1～31 で、その年と月に対して有効である必要があります。または、日が重要でない場合に、年のみか年と月を指定するには 0 にする必要があります。

enum (BusinessType)

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

object (Places)

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

string

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

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

ここで指定する地域は、このビジネスがサービスを提供する地域とは異なる地域を指定できます（ビジネス拠点以外の地域でサービスを提供する非店舗型ビジネスなど）。

ビジネス情報の作成後にオーナー確認が必要な場合は、オーナー確認の目的で指定した住所がその地域にある必要があります。また、ビジネス オーナーまたはその正式な代表者は、指定されたオーナー確認用住所で郵便物を受け取れる必要があります。

object (PlaceInfo)

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

string

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

string

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

string

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

number

緯度（度単位）。範囲 [-90.0, +90.0] 内になければなりません。

number

経度（度単位）。範囲 [-180.0, +180.0] 内になければなりません。

enum (OpenForBusiness)

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

boolean

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

object (Date)

省略可。ビジネスが開業した日付です。正確な日付が不明な場合は、年月のみを指定できます。過去の日付か、今後 1 年以内の日付を指定してください。

boolean

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

boolean

出力専用。このビジネスのプロパティのいずれかが「編集待ち」状態かどうかを示します。

boolean

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

boolean

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

boolean

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

boolean

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

boolean

出力専用。ビジネスが健康に関するデータを利用できるかどうかを示します。

boolean

出力専用。ビジネスが宿泊施設データを利用できるかどうかを示します。

string

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

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

string

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

string

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

string

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

boolean

出力専用。リスティングがビジネス コールに対応しているかどうかを示します。

boolean

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

string

必須。場所の説明を自分の声で記述します。他のユーザーは編集できません。

object (RelevantLocation)

このビジネスが関係している親ビジネスです。

object (RelevantLocation)

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

string

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

string

必須。プレイス ID を使用して、リレーションの反対側にあるビジネスを指定します。

enum (RelationType)

必須。関係のタイプ。

string

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

object (TimePeriod)

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

object (Money)

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

object (StructuredServiceItem)

省略可。このフィールドは、構造化サービスデータの大文字と小文字を設定します。

object (FreeFormServiceItem)

省略可。このフィールドは、自由形式のサービスデータの大文字 / 小文字が設定されます。

string

必須。serviceTypeId フィールドは Google 提供の一意の ID で、ServiceType で確認できます。この情報は、categories.batchGet rpc サービスから提供されます。

string

省略可。構造化サービス項目の説明。最大文字数は 300 文字です。

string

必須。カテゴリ名（カテゴリの固定 ID）を表します。category と serviceTypeId は、Category メッセージで指定されている可能な組み合わせと一致している必要があります。

object (Label)

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

string

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

string

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

string

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

string

ISO 4217 で定義されている 3 文字の通貨コード。

string (int64 format)

金額の整数部分。たとえば、currencyCode が "USD" の場合、1 単位は 1 米ドルです。

integer

金額の小数部分をナノ（10^-9）単位で表した数。値は -999,999,999 以上 +999,999,999 以下でなければなりません。units が正の場合、nanos には正数または 0 を指定します。units がゼロの場合、nanos には正数、0、または負数を指定できます。units が負の場合、nanos は負数または 0 を指定します。たとえば、$-1.75 は units = -1、nanos = -750,000,000 と表されます。