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

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

languageCode

string

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

storeCode

string

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

title

string

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

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

Methods

delete

ビジネスを削除します。

get

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

getAttributes

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

getGoogleUpdated

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

patch

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

updateAttributes

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