重要なエンドポイントが無効化される前に、Google Business Profile API 統合をアップデートする必要があります。2022 年 4 月から発生する可能性がある機能中断を避けるため、サポート終了スケジュールと説明を参照しましょう。

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. - 本社のマウンテン ビューなど)。マーケティング タグライン、店舗コード、特殊文字、営業時間、閉店状況、電話番号、ウェブサイトの 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)

(省略可)販売者がサポートするサービスのリスト。ヘアカットや給湯器の設置などのサービスがあります。重複しているサービス アイテムは自動的に削除されます。

Methods

associate

ビジネスをプレイス ID に関連付けます。

clearLocationAssociation

ビジネスとそのプレイス ID の関連付けをクリアします。

delete

ビジネスを削除します。

get

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

getAttributes

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

getGoogleUpdated

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

patch

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

updateAttributes

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