Skip to main content
PATCH
ユーザーを更新
ソーシャルネットワークのアカウントまたはユーザーデータを更新します。現在、Google Business ProfileとWhatsAppがサポートされています。
Googleは、一部のGoogle Business Profileの場所フィールドの更新を、ローリング24時間以内に5回まで制限しています。たとえば、ローリング24時間以内にphoneNumbersの更新が5回を超えると、400レスポンスが返されます。この制限はGoogle Business Profile固有のものであり、WhatsAppには適用されません。

ヘッダーパラメータ

パスパラメータ

string
必須
値: gbp, whatsapp

ボディパラメータ

object
顧客が事業と連絡を取るために使用できるさまざまな電話番号を含むオブジェクト。
string
この場所に対するGoogleの識別子(形式)。
string
場所のプライマリ電話番号ではなく、AdWords場所拡張機能に表示する代替電話番号。
string
この場所の外部識別子。特定のアカウント内で一意である必要があります。これは、独自のレコードと場所を関連付ける手段です。
string
場所の名前は、店頭、ウェブサイト、文房具で一貫して使用されており、顧客に知られている、あなたのビジネスの実際の名前を反映する必要があります。
string
このビジネスのURL。
array
ビジネスにタグを付けることができる自由形式の文字列のコレクション。これらのラベルはユーザーに表示されず、あなただけが見ることができます。ラベルごとに1〜255文字である必要があります。
object
緯度/経度のペアを表すオブジェクト。これは度緯度と度経度を表すためのdoubleのペアとして表現されます。特に指定されていない限り、このオブジェクトはWGS84標準に準拠する必要があります。
値は正規化された範囲内である必要があります。度単位の緯度。範囲は[-90.0, +90.0]である必要があります。度単位の経度。範囲は[-180.0, +180.0]である必要があります。
object
このフィールドには、自分の言葉で場所の説明が含まれます。この説明は他の誰も編集できません。

WhatsApp

WhatsAppはPrivate Betaです。 WhatsAppビジネスプロファイルを更新するには、WhatsAppの利用が承認されたアカウントが必要です。早期アクセスをご希望の場合は、lotty@ayrshare.comまでメールでお問い合わせください。
変更したいフィールドのみを送信してください。少なくとも1つのフィールドが必要であり、このエンドポイントが認識しないフィールドを送信すると、リクエスト全体が拒否されます。 フィールドをクリアするには、空文字列として送信します。{"description": ""}を送信すると説明が削除され、そのフィールドはプロファイルにまったく表示されなくなります。これはdescription、address、emailで機能します。aboutでは機能しません。WhatsAppはaboutに少なくとも1文字を必要とするため、変更する場合は上書きしてください。verticalも一度設定すると、クリアできません。 レスポンスフィールドのmessaging_productとprofile_picture_url(WhatsAppビジネスプロファイルを参照)は読み取り専用です。いずれかを送り返すと、認識されないフィールドとして拒否されます。写真を設定するにはprofilePictureUrlを使用してください。
string
プロファイル画像の下に表示されるテキスト。1〜139文字。これはWhatsAppがクリアを許可しない唯一のテキストフィールドです。代わりに上書きしてください。
string
ビジネスの説明。最大512文字。クリアするには""を送信してください。
string
ビジネスの住所。最大256文字。クリアするには""を送信してください。
string
連絡先のメールアドレス。最大128文字。クリアするために""を送信する場合を除き、有効なアドレスである必要があります。
array
それぞれhttp://またはhttps://で始まる、最大2つのURLの空でない配列。
string
ビジネスカテゴリ。WhatsAppは現在、次の値を受け付けます: OTHER, AUTO, BEAUTY, APPAREL, EDU, ENTERTAIN, EVENT_PLAN, FINANCE, GROCERY, GOVT, HOTEL, HEALTH, NONPROFIT, PROF_SERVICES, RETAIL, TRAVEL, RESTAURANT, ALCOHOL, ONLINE_GAMBLING, PHYSICAL_GAMBLING, OTC_DRUGS, MATRIMONY_SERVICE。このリストはWhatsAppによるものであり、今後増える可能性があります。Ayrshareは値を制限しないため、WhatsAppが受け付けるカテゴリであればどれでも機能します。大文字に正規化されるため、retailとして送信された値はRETAILとして返されます。WhatsAppは一度設定されたカテゴリのクリアを許可せず、受け付けない値は拒否します。この拒否は、現在受け付けられる値を列挙したWhatsApp自身のメッセージとともに101として返されます。
string
公開アクセス可能なJPEGまたはPNGで、5 MB以下。画像は正方形で、192×192以上である必要があります。640×640が推奨されます。最大解像度はありません。より大きな画像は受け入れられ、WhatsAppによって縮小されます。正方形でない画像や192×192未満の画像は、WhatsAppに何かが送信される前に、問題を示す400で拒否されます。すべての要件についてはWhatsAppメディアガイドラインを参照してください。