Konum işlem bağlantıları

Bir konumun Google işlem düğmelerini (sipariş, teslimat, paket servis, rezervasyon, randevu) Listings API üzerinden yönetin.

Yer işlemi bağlantıları, Google'ın bir işletmenin profilinde gösterdiği işlem düğmeleridir: Order online (İnternetten sipariş verin), Get delivery (Teslimat isteyin), Reserve a table (Masa ayırtın), Book an appointment (Randevu alın) vb. Listings API bunları konumun bir parçası olarak yönetir; bu nedenle bunları zaten kullandığınız oluşturma ve güncelleme uç noktaları üzerinden ayarlar ve tüm konum okuma uç noktaları üzerinden okuyabilirsiniz.

`placeActionLinks` alanı

Hem oluşturma hem de güncelleme işlemleri, input üzerinde bir placeActionLinks dizisi kabul eder. Her öğe:

Alan	Tür	Zorunlu	Açıklama
`placeActionType`	enum	evet	Aşağıdaki geçerli türlerden biri.
`uri`	string	evet	Hedef URL.
`isPreferred`	boolean	hayır	Bu bağlantıyı kendi türü için tercih edilen bağlantı olarak işaretler. Her tür için en fazla bir tercih edilen bağlantı olabilir.
`action`	string	hayır	`add` (varsayılan) veya `delete`. Yalnızca güncelleme işleminde kullanılır.
`name`	string	hayır	Bağlantı Google'a senkronize edildikten sonra okuma uç noktaları tarafından döndürülen bağlantı tanımlayıcısı. Yazma işleminde isteğe bağlıdır; kaydedilmiş belirli bir bağlantıyı en doğru şekilde hedeflemek için mevcut olduğunda ekleyin.

Geçerli placeActionType değerleri:

Code

APPOINTMENT   ONLINE_APPOINTMENT   DINING_RESERVATIONFOOD_ORDERING   FOOD_DELIVERY   FOOD_TAKEOUT   SHOP_ONLINE

Bir bağlantı nasıl eşleştirilir (düzenleme / silme için): varsa name ile, yoksa placeActionType + uri ile. En doğru eşleşme için, elinizde varsa (bir okuma işleminden aldıysanız) name ekleyin. Henüz Google'a senkronize edilmemiş yeni bir bağlantının name değeri yoktur; bu nedenle placeActionType + uri ile eşleştirilir.

İşlemler

Yazma modeli append/upsert modelidir; replace değildir. Güncelleme işleminde yalnızca belirttiğiniz bağlantılar etkilenir; dahil etmediğiniz bağlantılar değiştirilmeden bırakılır.

İşlem	Amaç	Eşleştirme
`add`	Yeni bir bağlantı ekleyin veya kaydedilmiş bir bağlantının `uri` / `isPreferred` değerlerini yerinde güncelleyin.	Varsa `name`, yoksa `placeActionType` + `uri`
`delete`	Kaydedilmiş bir bağlantıyı kaldırın ve Google'dan kaldırılmasını kuyruğa alın.	Varsa `name`, yoksa `placeActionType` + `uri`

Bir bağlantının URL'sini değiştirmek için aynı istekte eski bağlantıyı kaldırıp yeni bağlantıyı ekleyin (Bir bağlantının URL'sini değiştirme bölümüne bakın).

Önerilen akışlar

Bir konumun yer işlemi bağlantılarının eklenmesi ve Google ile senkronize tutulması için desteklenen iki yöntem vardır.

Akış 1: Önce Google'da oluşturun, ardından bağlayın

İşletme sahibi, yer işlemi bağlantılarını doğrudan kendi Google Business Profile profilinde ayarlar.
Söz konusu Google Business Profile konumu Listings API'ye bağlanır.
Bağlantı kurulduğunda Listings API, Google'daki yayındaki bağlantıları alır ve konumun yönetilen bağlantılar kümesine ekler. Bunları API üzerinden yeniden girmeniz gerekmez.

Akış 2: Önce Listings API'de oluşturun, ardından bağlayın

Konumu yer işlemi bağlantılarıyla birlikte Listings API'de oluşturun (konum oluşturma) veya bağlantıları daha sonra ekleyin (konum güncelleme).
Google Business Profile'a bağlanıldığında Listings API, yayındaki bağlantıları alır ve bunları yönetilen kümeyle birleştirir:
- sorunsuz eşleşen bağlantılar yönetilen kümeye katılır;
- Google'da bulunan ve otomatik olarak birleştirilemeyen (ya da sadece henüz yönetilen kümede yer almayan) tüm bağlantılar, incelemeniz için discoveredPlaceActionLinks altında gösterilir.
Google'a yapılan her gönderimde Listings API, yayındaki bağlantıları yeniden kontrol eder. Doğrudan Google Business Profile'da bulunan ve Listings API'nin yönetmediği her yeni bağlantı discoveredPlaceActionLinks alanına eklenir.

Keşfedilen bağlantılar

Keşfedilen bağlantılar, işletmenin Google profilinde bulunan ancak Listings API içinde yönetilmeyen yer işlemi bağlantılarıdır. Bunlar yukarıdaki akışlar aracılığıyla alınır (bağlantı kurulurken bulunan ek bağlantılar veya daha sonraki bir gönderimde bulunan yeni bağlantılar) ve tüm okuma uç noktaları tarafından yönetilen bağlantılarınızdan ayrı olarak, discoveredPlaceActionLinks altında (placeActionLinks ile aynı yapıda) döndürülür: listeleme, ID'lere göre, mağaza kodlarına göre ve arama.

JSON

{  "id": "TG9jYXRpb246MTgwMTAyMQ==",  "placeActionLinks": [ /* links you already manage */ ],  "discoveredPlaceActionLinks": [    {      "placeActionType": "APPOINTMENT",      "uri": "https://book.example.com",      "isPreferred": false,      "name": "locations/1944.../placeActionLinks/abc123",      "providerType": "MERCHANT",      "isEditable": true    }  ]}

Keşfedilen bir bağlantının yönetimini devralın

Keşfedilen bir bağlantıyı yönetmeye başlamak için, herhangi bir bağlantı eklerken kullandığınız çağrının aynısını kullanarak bağlantıyı action: "add" ile konum güncelleme uç noktasına gönderin (bağlantı placeActionType + uri ile tanımlanır). Diğer bağlantılar değiştirilmez.

Shell

curl -X POST 'https://listingsapi.com/api/v4/locations/update' \  -H "Authorization: API $LISTINGSAPI_KEY" \  -H 'Content-Type: application/json' \  -d '{    "input": {      "id": "<encoded-location-id>",      "placeActionLinks": [        { "placeActionType": "APPOINTMENT", "uri": "https://book.example.com", "isPreferred": false, "action": "add" }      ]    }  }'

Bundan sonra bağlantı placeActionLinks altında görünür ve discoveredPlaceActionLinks içinden kaldırılır. Yönetimini devralmadığınız keşfedilen bir bağlantı listede kalır (ve daha sonra Google'dan kaybolursa kendiliğinden listeden çıkar); herhangi bir işlem yapmanız gerekmez.

Örnekler

Her güncelleme, konumun değişikliği yansıtan eksiksiz ve güncel placeActionLinks kümesini döndürür. Bir yazma işleminden hemen sonra, bir bağlantının name ve submissionStatus alanları null değerindedir; bağlantı Google ile eşitlendiğinde bu alanlar doldurulur.

Bağlantı ekleyin

Shell

curl -X POST 'https://listingsapi.com/api/v4/locations/update' \  -H "Authorization: API $LISTINGSAPI_KEY" \  -H 'Content-Type: application/json' \  -d '{    "input": {      "id": "<encoded-location-id>",      "placeActionLinks": [        { "placeActionType": "FOOD_ORDERING", "uri": "https://order.example.com", "isPreferred": true, "action": "add" }      ]    }  }'

Bir bağlantının URL'sini değiştirin

URL değişikliği, aynı istekte eski bağlantının kaldırılması ve yeni bağlantının eklenmesiyle yapılır. Eski bağlantı Google ile eşitlenmişse, en doğru eşleşme için delete içinde bu bağlantının name değerini de belirtin; aksi takdirde placeActionType + uri kullanılır.

Shell

curl -X POST 'https://listingsapi.com/api/v4/locations/update' \  -H "Authorization: API $LISTINGSAPI_KEY" \  -H 'Content-Type: application/json' \  -d '{    "input": {      "id": "<encoded-location-id>",      "placeActionLinks": [        { "placeActionType": "FOOD_ORDERING", "uri": "https://order.example.com",     "name": "<link-name-if-synced>", "action": "delete" },        { "placeActionType": "FOOD_ORDERING", "uri": "https://new-order.example.com", "isPreferred": true, "action": "add" }      ]    }  }'

Yalnızca isPreferred değerini değiştirmek için (URL aynı kalacak şekilde), bağlantıyı action: "add" ve yeni değer ile yeniden gönderin.

Bağlantı kaldırın

Shell

curl -X POST 'https://listingsapi.com/api/v4/locations/update' \  -H "Authorization: API $LISTINGSAPI_KEY" \  -H 'Content-Type: application/json' \  -d '{    "input": {      "id": "<encoded-location-id>",      "placeActionLinks": [        { "placeActionType": "FOOD_DELIVERY", "uri": "https://deliver.example.com", "name": "<link-name-if-synced>", "action": "delete" }      ]    }  }'

Bağlantıları olan bir konum oluşturun

Oluşturma sırasında her bağlantı yeni olduğundan, action varsayılan olarak add değerini alır.

Shell

curl -X POST 'https://listingsapi.com/api/v4/locations' \  -H "Authorization: API $LISTINGSAPI_KEY" \  -H 'Content-Type: application/json' \  -d '{    "input": {      "name": "Acme Dental",      "description": "<business description, minimum 200 characters>",      "countryIso": "US",      "city": "New York",      "subCategoryId": 1432,      "placeActionLinks": [        { "placeActionType": "APPOINTMENT", "uri": "https://book.acmedental.example.com", "isPreferred": true },        { "placeActionType": "ONLINE_APPOINTMENT", "uri": "https://virtual.acmedental.example.com" }      ]    }  }'

Notlar

En fazla tür başına bir tercih edilen bağlantı olabilir.
Bir bağlantının submissionStatus alanı, insanlar tarafından okunabilir bir submissionMessage ile birlikte Google ile yapılan son eşitlemeyi (success, failed vb.) yansıtır.
Google, yer işlemi bağlantılarını yalnızca doğrulanmış konumlara uygular.