REST Resource: 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

必須。ビジネス拠点の名前は、店舗、ウェブサイト、事務用品で一貫して使用されており、顧客に知られている実際のビジネスの名称である必要があります。関連する追加情報は、リソースの他のフィールド(AddressCategories など)に含めることができます。名前に不要な情報を追加しないでください(たとえば、「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)

省略可。販売者が対応しているサービスのリスト。サービスには、散髪や給湯器の設置などが含まれます。重複するサービス アイテムは自動的に削除されます。

メソッド

delete

ビジネスを削除します。

get

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

getAttributes

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

getGoogleUpdated

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

patch

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

updateAttributes

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