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

ID。このビジネスの Google 識別子は locations/{locationId} の形式です。
languageCode

string

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

string

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

string

必須。ビジネスの名前は、店舗、ウェブサイト、販促品などで一貫して使用され、一般に知られているビジネスの実際の名称を反映させる必要があります。関連する追加情報は、リソースの他のフィールド（Address、Categories など）に含めることができます。名前に不要な情報を追加しないでください（たとえば、「Google Inc. - Mountain View Corporate Headquarters」ではなく「Google」を使用します）。マーケティング用のキャッチフレーズ、店舗コード、特殊文字、営業時間、営業中 / 閉店中のステータス、電話番号、ウェブサイトの URL、商品情報、場所 / 住所、道案内、店舗内店舗の情報（例: 「Duane Reade 内の Chase ATM」）は含めないでください。
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 番号は指定できません）。

カテゴリ

ビジネスを表すカテゴリのコレクション。更新中は、両方のフィールドを設定する必要があります。クライアントは、更新マスクを使用してメインカテゴリまたは追加カテゴリを個別に更新することはできません。

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

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

string

省略可。一般的に住所の市町村部分を指します。たとえば、米国の市、イタリアのコムーネ、英国の郵便町名などがこれに該当します。国 / 地域によっては、これに相当する地域区分が明確に定義されていない場合や、この構造にうまく適合しない場合がありますが、その場合は locality を空のままにして addressLines を使用します。
sublocality

string

省略可。住所の市町村部分の下位の区画。たとえば、近隣地域、区、地区などです。
addressLines[]

string

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

addressLines の値には型情報がなく、1 つのフィールドに複数の値が含まれることがあるため（例: 「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 時を表します。注: Proto3 JSON マッピングでは、デフォルトのゼロ値（00:00）は省略され、openTime に {} が生成されます。
closeDay

enum (DayOfWeek)

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

object (TimeOfDay)

必須。有効な値は 00:00〜24:00 で、24:00 は曜日フィールドで指定した日が終了する深夜 0 時を表します。注: Proto3 JSON マッピングでは、デフォルトのゼロ値（00:00）は省略され、closeTime に {} が生成されます。

DayOfWeek

曜日を表します。

列挙型
DAY_OF_WEEK_UNSPECIFIED 曜日は指定されていません。
MONDAY 月曜日
TUESDAY 火曜日
WEDNESDAY Wednesday
THURSDAY 木曜日
FRIDAY 金曜日
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 で指定した日付は、ビジネスが終日休業する日として扱われます。

日付

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

  • 年の値がゼロ以外である月と日の値を含む完全な日付
  • 年の値がゼロである月と日（記念日など）。
  • 月と日の値がゼロである単独の年。
  • 日の値がゼロである年と月（クレジット カードの有効期限など）

関連するタイプ:

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

integer

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

integer

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

integer

1 月の中の日付。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,
  "isParticularlyPersonalPlace": boolean
}
フィールド
hasGoogleUpdated

boolean

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

boolean

出力専用。このビジネス拠点のプロパティに「編集内容が審査中」かどうかが示されるようになりました。
canDelete

boolean

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

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 of Merchant がない理由の詳細を取得する必要があります。
isParticularlyPersonalPlace

boolean

出力専用。ビジネスが「特に個人的な場所」に分類されているかどうかを示します。つまり、ロケーション履歴の機能に制限があります。間違いであると思われる場合は、ヘルプセンターの記事をご覧ください。

プロフィール

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

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 これは、1 つの物理的なエリア、同じブランド / 上位管理 / 組織を共有しているものの、営業時間や電話番号などの主要な属性が異なる 2 つの場所の関係を表します。たとえば、Costco Pharmacy は Costco Wholesale の部門です。
INDEPENDENT_ESTABLISHMENT_IN これは、2 つの店舗が同じ物理的な場所に併設されているものの、異なる会社に属している場合（例: Safeway 内の Starbucks、ショッピング モール内の店舗）を表します。

MoreHours

特定の種類のビジネスで、ビジネス拠点が営業している期間。

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

string

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

object (TimePeriod)

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

ServiceItem

1 つのサービス項目を説明するメッセージ。販売者が提供するサービスの種類を記述するために使用されます。たとえば、ヘアカットはサービスです。

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of mutually exclusive fields.
}
フィールド
price

object (Money)

省略可。サービス アイテムの金額を表します。価格を含める場合は、currencyCode と units を設定することをおすすめします。これは、サービス アイテムの固定価格として扱われます。
次のいずれかのフィールドを常に設定する必要があります。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。
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

販売者が提供する自由形式のサービスを表します。これらは、構造化サービスデータの一部として公開されていないサービスです。販売者は、GeoMerchant サーフェスを使用して、このようなサービスの名前を手動で入力します。

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

string

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

object (Label)

必須。アイテムの言語タグ付きラベル。アイテム名は 140 文字以下、説明は 250 文字以下にすることをおすすめします。このフィールドは、入力がカスタム サービス アイテムの場合にのみ設定する必要があります。標準化されたサービスタイプは、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 には正数または 0 を指定します。units がゼロの場合、nanos には正数、0、または負数を指定できます。units が負の場合、nanos は負数または 0 を指定します。たとえば、$-1.75 は units = -1、nanos = -750,000,000 と表されます。

メソッド

create

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

list

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