REST Resource: accounts.locations

リソース: Location

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

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 Corporate 本社」よりも「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 値が受け入れられた場合、または latlng 値が Google ビジネス プロフィールのウェブサイトで更新された場合にのみ、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

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

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

プロフィール

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

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

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

enum (RelationType)

必須。関係のタイプ。

RelationType

指定するリレーションのタイプ。

列挙型
RELATION_TYPE_UNSPECIFIED 未指定
DEPARTMENT_OF これは、1 つの物理的エリア、同じブランド/経営陣/組織を共有しているが、営業時間や電話番号などの主要な属性が異なる 2 つのビジネス拠点間の関係を表しています。たとえば、コストコ薬局はコストコ卸売業の部門です。
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 と unit を設定することをおすすめします。これはサービス アイテムの固定価格として扱われます。
共用体フィールド 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

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

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

string

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

object (Label)

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

ラベル

価格表、セクション、またはアイテムを表示するときに使用されるラベル。

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

string

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

string

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

string

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

Money

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

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

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