Google ビジネス プロフィール（GBP）API を使用すると、特定の場所の WhatsApp とテキスト メッセージの URL 属性を追加または更新できます。
これらの属性を実装すると、顧客は WhatsApp または SMS を使用してビジネスに連絡できるようになります。これにより、販売者は GBP でユーザーとの直接的なコミュニケーション チャネルを開き、顧客エンゲージメントとサポートを改善できます。
ここでは、URL 属性を追加、更新、削除する方法について説明します。
前提条件
続行する前に、次の準備が整っていることを確認してください。
- Google ビジネス プロフィール アカウントと店舗
- Google ビジネス プロフィールの所在地を変更するために必要な認証情報
成功を検証する
属性を追加、更新、削除するには、PATCH リクエストを送信します。PATCH リクエストが成功すると、ステータス コード HTTP 200 OK が返されます。
属性の追加または更新をリクエストする
このアプローチは、WhatsApp とテキスト メッセージングの両方に適用されます。
1 つの属性を追加または更新するには、location.updateattributes の Google Business Profile API エンドポイントに送信される HTTP PATCH リクエストを使用します。
URL の attributeMask クエリ パラメータを使用して、ターゲットとする属性を指定します。リクエストの本文には、更新された属性データが含まれます。
WhatsApp の場合
リクエストは次のようになります。
PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}/attributes?attributeMask=attributes/url_whatsapp
実装時に、{locationId} を Google ビジネス プロフィールの場所の実際の ID に置き換えます。
リクエストの本文（application/JSON）は次のようになります。
{
"name": "locations/17826990302864573181/attributes",
"attributes": [
{
"name":"attributes/url_whatsapp",
"values":[],
"uriValues": [
{
"uri": "https://wa.me/55555555"
}
]
}
]
}
例の 55555555 は、国際形式のビジネス WhatsApp 電話番号に置き換えます。
テキスト メッセージの場合
リクエストは次のようになります。
PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}/attributes?attributeMask=attributes/url_text_messaging
実装時に、{locationId} を Google ビジネス プロフィールの場所の実際の ID に置き換えます。
リクエストの本文（application/JSON）は次のようになります。
{
"name": "locations/17826990302864573181/attributes",
"attributes": [
{
"name":"attributes/url_text_messaging",
"values":[],
"uriValues": [
{
"uri": "sms:5555555555"
}
]
}
]
}
例の sms:5555555555 は、テキスト メッセージ用のビジネス電話番号に置き換えます。
属性を削除する
DELETE リクエストで両方の属性を削除するには、attributeMask クエリ パラメータに attributes/url_whatsapp または attributes/url_text_messaging を含めます。リクエスト本文には、更新または削除する属性ごとに 1 つずつ、属性オブジェクトの配列が含まれます。
リクエストは次のようになります。
DELETE
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}/attributes?attributeMask=attributes/url_whatsapp,attributes/url_text_messaging3
実装時に、{locationId} を Google ビジネス プロフィールの場所の実際の ID に置き換えます。
リクエストの本文（application/JSON）は次のようになります。
{
"name": "locations/17826990302864573181/attributes",
"attributes": [
{
"name":"attributes/url_whatsapp",
"values":[],
"uriValues": []
}
]
}
例の uriValues は、空の角かっこに置き換えます。これにより、値がリセットされ、GBP から削除されます。