Bağlı hesaptaki işletme kaydından konum oluşturun

Bağlı bir Google Business Profile veya Facebook hesabındaki mevcut bir işletme kaydından işletme verilerini alarak yeni bir Listings API konumu oluşturur. İşletme kaydı hesapta zaten mevcut olmalı (POST /connected-accounts/connected-account-listings aracılığıyla alınmış olmalı) ve başka bir Listings API konumuna bağlı olmamalıdır.

İstek yapısı. Gövde, iki zorunlu alan içeren bir input nesnesi içinde yer almalıdır: connectedAccountId (işletme kaydının sahibi olan hesap) ve connectedAccountListingId (içe aktarılacak işletme kaydı). listingId alanı yoktur; şema bu alanı reddeder.

Google işletme kayıtları için API; ad, adres, koordinatlar, telefon, web sitesi, açıklama, normal ve özel çalışma saatleri, birincil ve ek kategoriler, açılış tarihi, mağaza kodu ve saat dilimini içe aktarır. Ödeme yöntemleri ve sosyal profil bağlantıları, işletme kaydının Google özelliklerinden elde edilir. Ödeme yöntemleri ve sosyal bağlantılar dışındaki Google özellikleri okunur ancak saklanmaz. Facebook için ad, konum, çalışma saatleri, kategoriler, açıklama ve iletişim bilgilerini içe aktarır.

Yeni konum, verilerin alındığı bağlı hesaba otomatik olarak bağlanır. Google'dan içe aktarma işleminde veriler Google'a yeniden gönderilmez. İçe aktarma için kullandığınız profil olduğu gibi bırakılır ve ilk POST /api/v4/locations/update bu profile veri yayımlayana kadar profilin işletme kaydı syncStatus: IN_PROGRESS durumunu bildirir. Diğer tüm yayın platformlarında normal işlem uygulanır: sipariş kalemleri oluşturulur ve konum, hesapta etkinleştirilmiş diğer sitelerin her birine gönderilir.

Bu endpoint site kapsamı veya gönderimleri devre dışı bırakma seçeneği kabul etmez, bu nedenle konum her zaman hesabınızdaki tüm yayın platformlarını kapsayacak şekilde oluşturulur. Konumu tek bir yayın platformuyla sınırlamak için oluşturma işleminden hemen sonra yeni konumda POST /api/v4/locations/update aracılığıyla enabledSiteIds ayarını yapın. Bu güncellemeyi konum oluşturulur oluşturulmaz gönderin: diğer yayın platformları için sipariş kalemleri oluşturma işleminden kısa süre sonra oluşturulur ve güncelleme, önceden oluşturulmuş sipariş kalemlerini geri çekmez.

Kullanım senaryosu: ilk kurulum sırasında konumları toplu olarak oluşturma. Bir ajans, müşterisinin Google hesabını bağlar; bu hesap, ajansın Listings API'ye daha önce hiç eklemediği 40 mağazayı yönetmektedir. Her konumu elle oluşturmak yerine hesabın işletme kayıtlarını listeleyin ve Google verileriyle önceden doldurulmuş 40 Listings API konumunun tümünü oluşturmak için her connectedAccountListingId için bu endpoint'i bir kez çağırın, ardından bunları normal şekilde faturalandırın ve yönetin.

success: true, konumun oluşturulduğu anlamına gelir ve locationId, konumun veritabanı kimliğidir. Başarısızlık durumunda success değeri false, locationId değeri null olur ve errors, yapılandırılmış, kod içeren bir neden taşır; örneğin connectedAccountListingId çözümlenemediğinde { "code": "SY81067", "message": "Invalid connected account listing ID" }. Diğer yaygın durumlar, bir işletme kaydının zaten başka bir konuma bağlı olması veya bir hesabın kimlik bilgilerinin süresinin dolmuş olması ve hesabın connect-google ya da connect-facebook endpoint'i aracılığıyla yeniden bağlanmasının gerekmesidir. Yeni bir konum oluşturmak yerine bir işletme kaydını mevcut bir konuma bağlamak için connect-listing endpoint'ini kullanın.