REST Resource: accounts.locations

リソース: ロケーション

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

JSON 表現 
{
  "name": string,
  "languageCode": string,
  "storeCode": string,
  "title": string,
  "phoneNumbers": {
    object (PhoneNumbers)
  },
  "categories": {
    object (Categories)
  },
  "storefrontAddress": {
    object (PostalAddress)
  },
  "websiteUri": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "metadata": {
    object (Metadata)
  },
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ],
  "serviceItems": [
    {
      object (ServiceItem)
    }
  ]
}
フィールド
name

string

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

string

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

string

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

string

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

object (PhoneNumbers)

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

object (Categories)

（省略可）ビジネスを表すさまざまなカテゴリ。
storefrontAddress

object (PostalAddress)

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

string

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

object (BusinessHours)

（省略可）ビジネスの営業時間。
specialHours

object (SpecialHours)

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

object (ServiceAreaBusiness)

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

string

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

object (AdWordsLocationExtensions)

（省略可）AdWords に表示される追加情報。
latlng

object (LatLng)

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

object (OpenInfo)

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

object (Metadata)

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

object (Profile)

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

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

object (RelationshipData)

（省略可）このビジネスに関連するすべてのビジネス拠点とチェーンです。
moreHours[]

object (MoreHours)

（省略可）ビジネスの各部門や特定の顧客の営業時間の詳細。
serviceItems[]

object (ServiceItem)

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

PhoneNumbers

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

JSON 表現 
{
  "primaryPhone": string,
  "additionalPhones": [
    string
  ]
}
フィールド
primaryPhone

string

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

string

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

Categories

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

JSON 表現 
{
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}
フィールド
primaryCategory

object (Category)

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

object (Category)

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

カテゴリ

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

JSON 表現 
{
  "name": string,
  "displayName": string,
  "serviceTypes": [
    {
      object (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}
フィールド
name

string

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

string

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

object (ServiceType)

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

object (MoreHoursType)

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

ServiceType

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

JSON 表現 
{
  "serviceTypeId": string,
  "displayName": string
}
フィールド
serviceTypeId

string

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

string

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

MoreHoursType

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

JSON 表現 
{
  "hoursTypeId": string,
  "displayName": string,
  "localizedDisplayName": string
}
フィールド
hoursTypeId

string

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

string

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

string

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

PostalAddress

郵便の配達先や支払場所などに使用される住所を表します。郵便住所がわかっていれば、郵便サービスによって住宅や私書箱などに商品を配達できます。これは地理的な場所（道路、町、山）を指し示すものではありません。

通常の用途では、住所はユーザーによる入力か既存データのインポートによって作成されます（プロセスの種類によります）。

住所の入力または編集に関するアドバイス: - https://github.com/google/libaddressinput など、多言語対応の住所ウィジェットを使用します。- フィールドの入力や編集に使用する UI 要素は、そのフィールドが使用されている国以外ではユーザーに表示しないでください。

このスキーマの使用方法の詳細については、https://support.google.com/business/answer/6397478 をご覧ください。

JSON 表現 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
フィールド
revision

integer

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

新しいリビジョンはすべて、古いリビジョンとの下位互換性を保つ必要があります。
regionCode

string

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

string

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

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

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

string

（省略可）住所の郵便番号。国によっては郵便番号が使用されていない場合や、指定する必要がない場合もありますが、使用されている場合は住所の他の部分と組み合わせて追加の検証を行うことができます（例: 米国での州と郵便番号の検証）。
sortingCode

string

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

string

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

string

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

string

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

string

構造化されていない住所の下位部分を記述する行。

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

住所の構造化表現として許容される最小限の形式は、regionCode を設定し、残りすべての情報を addressLines に格納するというものです。そのような住所はジオコーディングしなくてもおおよそフォーマットできますが、住所の構成要素の意味は、少なくとも部分的にわからなければ推測できません。

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

string

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

string

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

BusinessHours

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

JSON 表現 
{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
フィールド
periods[]

object (TimePeriod)

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

TimePeriod

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

JSON 表現 
{
  "openDay": enum (DayOfWeek),
  "openTime": {
    object (TimeOfDay)
  },
  "closeDay": enum (DayOfWeek),
  "closeTime": {
    object (TimeOfDay)
  }
}
フィールド
openDay

enum (DayOfWeek)

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

object (TimeOfDay)

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

enum (DayOfWeek)

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

object (TimeOfDay)

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

DayOfWeek

曜日を表します。

列挙型
DAY_OF_WEEK_UNSPECIFIED 曜日は指定されていません。
MONDAY 月曜日
TUESDAY 火曜日
WEDNESDAY 水曜日
THURSDAY 木曜日
FRIDAY Friday
SATURDAY Saturday
SUNDAY 日曜日

TimeOfDay

1 日のうちの時刻を表します。日付とタイムゾーンは意味を持たないか、他の場所で指定されています。API は、うるう秒を許可するようにできます。関連する型は、google.type.Date と google.protobuf.Timestamp です。

JSON 表現 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
フィールド
hours

integer

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

integer

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

integer

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

integer

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

SpecialHours

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

JSON 表現 
{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}
フィールド
specialHourPeriods[]

object (SpecialHourPeriod)

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

SpecialHourPeriod

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

startDate=2015-11-23, openTime=08:00, closeTime=18:00
startDate=2015-11-23, endDate=2015-11-23, openTime=08:00,
closeTime=18:00 startDate=2015-11-23, endDate=2015-11-24,
openTime=13:00, closeTime=11:59

次の入力は無効です。

startDate=2015-11-23, openTime=13:00, closeTime=11:59
startDate=2015-11-23, endDate=2015-11-24, openTime=13:00,
closeTime=12:00 startDate=2015-11-23, endDate=2015-11-25,
openTime=08:00, closeTime=18:00
JSON 表現 
{
  "startDate": {
    object (Date)
  },
  "openTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "closeTime": {
    object (TimeOfDay)
  },
  "closed": boolean
}
フィールド
startDate

object (Date)

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

object (TimeOfDay)

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

object (Date)

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

object (TimeOfDay)

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

boolean

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

日付

誕生日など、カレンダーの日付の全体または一部を表します。時刻とタイムゾーンは他の場所で指定されているか、重要ではありません。日付はグレゴリオ暦を基準にしています。次のいずれかを表します。

  • ゼロ以外の年、月、日の値を持つ完全な日付。
  • 年を含む月と日（記念日など）。
  • 0 か月がゼロの日と 0 日という単独の年。
  • 年と月、日がゼロ（クレジット カードの有効期限など）。

関連するタイプ:

JSON 表現 
{
  "year": integer,
  "month": integer,
  "day": integer
}
フィールド
year

integer

日付の年。1 ～ 9999 の範囲で指定するか、年のない日付を指定する場合は 0 にする必要があります。
month

integer

月。1 ～ 12 にする必要があります。月と日のない年を指定するには 0 を指定します。
day

integer

日。1 ～ 31 の範囲の年と月で指定でき、0 の場合は単独で年を指定するか、日付が重要でない年と月を指定します。

ServiceAreaBusiness

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

JSON 表現 
{
  "businessType": enum (BusinessType),
  "places": {
    object (Places)
  },
  "regionCode": string
}
フィールド
businessType

enum (BusinessType)

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

object (Places)

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

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 に更新する場合は、ビジネスの更新にフィールド マスク storefrontAddress を含めて、フィールドを空に設定する必要があります。
CUSTOMER_AND_BUSINESS_LOCATION ビジネスの住所とその周辺地域でサービスを提供します。

プレイス

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

JSON 表現 
{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}
フィールド
placeInfos[]

object (PlaceInfo)

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

PlaceInfo

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

JSON 表現 
{
  "placeName": string,
  "placeId": string
}
フィールド
placeName

string

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

string

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

AdWordsLocationExtensions

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

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

string

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

LatLng

緯度と経度のペアを表すオブジェクト。これは緯度を表す倍精度値と経度を表す倍精度値のペアで表現されます。特に明記されていない場合、このオブジェクトは WGS84 規格に準拠する必要があります。値は正規化範囲内で指定する必要があります。

JSON 表現 
{
  "latitude": number,
  "longitude": number
}
フィールド
latitude

number

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

number

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

OpenInfo

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

JSON 表現 
{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}
フィールド
status

enum (OpenForBusiness)

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

boolean

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

object (Date)

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

OpenForBusiness

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

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

メタデータ

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

JSON 表現 
{
  "hasGoogleUpdated": boolean,
  "hasPendingEdits": boolean,
  "canDelete": boolean,
  "canOperateLocalPost": boolean,
  "canModifyServiceList": boolean,
  "canHaveFoodMenus": boolean,
  "canOperateHealthData": boolean,
  "canOperateLodgingData": boolean,
  "placeId": string,
  "duplicateLocation": string,
  "mapsUri": string,
  "newReviewUri": string,
  "canHaveBusinessCalls": boolean,
  "hasVoiceOfMerchant": boolean
}
フィールド
hasGoogleUpdated

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

string

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

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

string

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

string

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

string

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

boolean

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

boolean

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

プロファイル

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

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

string

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

RelationshipData

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

JSON 表現 
{
  "parentLocation": {
    object (RelevantLocation)
  },
  "childrenLocations": [
    {
      object (RelevantLocation)
    }
  ],
  "parentChain": string
}
フィールド
parentLocation

object (RelevantLocation)

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

object (RelevantLocation)

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

string

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

RelevantLocation

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

JSON 表現 
{
  "placeId": string,
  "relationType": enum (RelationType)
}
フィールド
placeId

string

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

enum (RelationType)

必須。関係のタイプ。

RelationType

指定する型の関係。

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

MoreHours

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

JSON 表現 
{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
フィールド
hoursTypeId

string

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

object (TimePeriod)

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

ServiceItem

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

JSON 表現 
{
  "price": {
    object (Money)
  },

  // Union field service_item_info can be only one of the following:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of list of possible types for union field service_item_info.
}
フィールド
price

object (Money)

（省略可）サービス アイテムの金額を表します。価格を含める場合は currencyCode と単位を設定することをおすすめします。これはサービス アイテムの固定価格として扱われます。
共用体フィールド service_item_info。次のフィールドのいずれかを必ず設定する必要があります。service_item_info は次のいずれかになります。
structuredServiceItem

object (StructuredServiceItem)

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

object (FreeFormServiceItem)

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

StructuredServiceItem

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

JSON 表現 
{
  "serviceTypeId": string,
  "description": string
}
フィールド
serviceTypeId

string

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

string

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

FreeFormServiceItem

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

JSON 表現 
{
  "category": string,
  "label": {
    object (Label)
  }
}
フィールド
category

string

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

object (Label)

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

ラベル

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

JSON 表現 
{
  "displayName": string,
  "description": string,
  "languageCode": string
}
フィールド
displayName

string

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

string

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

string

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

通貨

金額をその通貨タイプで表します。

JSON 表現 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
フィールド
currencyCode

string

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

string (int64 format)

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

integer

金額のナノ（10^-9）単位の数。値は -999,999,999～+999,999,999 の範囲（両端を含む）で指定する必要があります。units が正の場合、nanos は正またはゼロでなければなりません。units がゼロの場合、nanos には正、ゼロ、または負の値を指定できます。units が負の場合、nanos は負の値または 0 でなければなりません。たとえば $-1.75 は units=-1、nanos=-750,000,000 と表されます。

Methods

create

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

list

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