Google ビジネス プロフィール(GBP)の属性は、ユーザー ポータルのユーザー インターフェースからビジネス情報に追加および編集できます。属性をドロップダウン リストで編集するには、ビジネスに特定のカテゴリが設定されている必要があります。API を使用してビジネス情報を管理する場合、GMB の属性も管理できます。
*属性は、選択した場所のプライマリ カテゴリに直接リンクされていることに注意してください。
これは3つのステップで実現できます。
利用可能なカテゴリの取得
利用可能なUberallカテゴリーの全リストは、以下のAPI呼び出しで取得できます。Uberallカテゴリーは、GBPカテゴリーおよびその他のディレクトリカテゴリーにリンクされています。このカテゴリーリストは、 API呼び出しドキュメントに記載されているパラメータを使用してさらに絞り込むことができます。API呼び出しを正常に実行するには、言語パラメータが必要です。
得る https://uberall.com/api/categories?language=en パラメータ = { "言語": ご希望の言語 } ヘッダー = { 「秘密鍵」: $API_KEY } 応答 = { { "状態": "成功"、 "応答": { "結果": [ { 「id」: 2、 "名前": "曳航 サービス"、 "フルネーム": 「自動車 そして 交通機関 > 交通機関 会社 そして サービス > 曳航 サービス"、 「選択可能」: 真実、 "親": 4126 }, { 「id」: 3、 "名前": 「自動 ガラス 店"、 "フルネーム": 「自動車 そして 交通機関 > ガレージ、 部品 そして アクセサリー > オート ガラス 店"、 「選択可能」: 真実、 "親": 4127 }, }
利用可能な属性の取得
APIでカテゴリIDを取得したら、それを使用してカテゴリごとに利用可能なGoogle属性のリストを取得できます。API呼び出しを正常に実行するには、 countryパラメータが必要です。詳細については、 API呼び出しのドキュメントをご覧ください。
得る https://uberall.com/API/categories/$CATEGORY_ID/attributes?language=en&country=CA パラメータ = { "国": $国 } ヘッダー = { 「秘密鍵」: $API_KEY } 応答 = { "状態": "成功"、 "応答": { 「属性」: [ { 「外部ID」: 「url_予約」、 "表示名": "予定 リンク", 「値の種類」: 「URL」、 「値のメタデータ」: ヌル }, { 「外部ID」: 「女性が所有している」 "表示名": 「識別する として 女性主導」 「値の種類」: 「ブール」、 「値のメタデータ」: [ { "価値": "真実"、 "表示名": 「識別する として 女性主導 } ] } ] } }
場所に属性を割り当てる
属性は既存の場所または新しい場所に追加できます。属性は、場所に関連付けられたプライマリカテゴリで使用できる必要があります。属性は、場所オブジェクトのAttributes要素部分で、 attributeWrapperオブジェクトの一部として定義する必要があります。完全なattributeWrapperオブジェクトは、 こちらで定義されています。
警告
更新しようとしている属性が支払い方法に関連する場合、 paymentOptionsフィールドも同時に更新する必要があります。どちらか一方のフィールドのみを更新した場合、更新は適用されません。
前の例で取得した属性データを考慮すると、プライマリカテゴリが「レッカーサービス」 (ID 2)であるロケーションには、 url_appointment属性とis_owned_by_women属性の両方を設定できます。これらの属性を関連付けるには、Attributes要素を次のように設定する必要があります。
「属性」: [ { "表示名": "予定 リンク", 「外部ID」: 「url_予約」、 "価値": 「https://yourURLhere.com」、 「値の種類」: 「URL」、 }, { "表示名": 「識別する として 女性主導」 「外部ID」: 「女性が所有している」 "価値": "真実"、 「値の種類」: 「ブール」 } ]