Bir konum için GMB işletme kaydı oluşturma

Parametreler

Gövde

Ad	Tür	Zorunlu	Açıklama
input	object	zorunlu	Wrapper object. The entire request body must be nested under `input`.
input.locationId	string	zorunlu	Base64-encoded location Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`) of the location to create the Google listing for.
input.connectedAccountId	string	zorunlu	UUID of the connected Google account the new listing should be created under. Taken from `GET /connected-accounts`.
input.folderId	string	isteğe bağlı	Google account group to create the listing inside, as the `accounts/{id}` string from the folders endpoint. Omit to create it at the account root.

Yanıtlar

200Request accepted. `success: true` means GMB listing creation was initiated.

Response

{  "data": {    "createGmbListingForLocation": {      "clientMutationId": null,      "success": true,      "errors": null    }  }}

400Bad request, the body was not wrapped in `input` (error message: `Variable "$input" of required type "CreateGmbListingForLocationInput!" was not provided`).

401Unauthenticated, missing or invalid API key.

Bir Listings API konumu için yepyeni bir Google Business Profile işletme kaydı oluşturur ve bu kaydı bağlı bir Google hesabıyla ilişkilendirir. Bir Listings API konumunu Google hesabında zaten var olan bir işletme kaydına bağlayan connect-listing işleminden farklı olarak, bu işlemi konumun henüz hiçbir Google işletme kaydı olmadığında kullanın.

İstek yapısı. Gövde, iki zorunlu alan içeren bir input nesnesi içinde yer almalıdır: locationId (konumun base64 ile kodlanmış Relay ID'si) ve connectedAccountId (işletme kaydının oluşturulacağı Google hesabı). folderId isteğe bağlıdır; yeni işletme kaydını belirli bir Google hesap grubuna yerleştirmek için bu değeri Klasörleri listeleme işleminden aldığınız biçimiyle, değiştirmeden iletin. Bir nesne içine alınmamış düz bir gövde gönderilmesi, HTTP 400 ile reddedilir.

Oluşturma işlemi eşzamansızdır: success: true, isteğin kabul edildiği anlamına gelir; işletme kaydının anında yayında olduğu anlamına gelmez. Google, yeni profilleri yayımlanmadan önce inceler.

Kullanım senaryosu: tamamen yeni bir mağaza için Google'da varlık oluşturma. Bir müşteri, henüz Google Business Profile profili olmayan yeni bir konum açar. Listings API konumunu oluşturun, müşterinin Google hesabını bağlayın, ardından Listings API'nin yeni işletme kaydını bu hesap altında Google'a göndermesi için konumun ID'si ve connectedAccountId ile bu uç noktayı çağırın. Ardından, işletme kaydının beklemede durumundan doğrulanmış durumuna geçişini izlemek için konumun işletme kayıtlarını düzenli aralıklarla sorgulayın.

Bir işletme kaydı oluşturulabilmesi için konumun önceden geçerli işletme bilgilerini (ad, adres, telefon) içermesi gerekir ve her konum için yalnızca bir Google işletme kaydı bulunabilir. Başarısızlık durumunda errors nedeni açıklar; genellikle konumda zorunlu alanlar eksiktir, konumun zaten bir Google işletme kaydı vardır, konum arşivlenmiştir veya bağlı hesap etkin değildir. Bağlantısı güncelliğini yitirmiş bir hesabı connect-google uç noktasıyla yeniden bağlayın. Uç noktanın şu anda connectedAccountId gerçek ve bağlı bir Google hesabı olmadığında bile success: true döndürdüğünü unutmayın; bu nedenle yalnızca success değerine güvenmek yerine işletme kaydının gerçekten göründüğünü (konumun işletme kayıtları üzerinden) doğrulayın.

curl -X POST 'https://listingsapi.com/api/v4/locations/create/gmb-listing' \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H 'Content-Type: application/json' \ -d '{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "connectedAccountId": "4f712c17-4f95-42dd-90f4-97171a2e67b5" } }'

Parametreler

Gövde

Örnek istek

Yanıtlar