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

省略可。販売者が対応しているサービスのリスト。サービスには、ヘアカット、給湯器の設置などがあります。重複するサービス項目は自動的に削除されます。

メソッド

delete

ビジネスを削除します。

get

販売者が最後に設定した指定のビジネス情報を返します。

getAttributes

販売者が最後に設定したビジネスの属性を取得します。

getGoogleUpdated

Google マップと Google 検索に表示されている指定されたビジネス情報を返します。

patch

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

updateAttributes

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