Google Business Performance API, tek bir API isteğinde birden fazla "GünlükMetrik" getirmeye olanak tanıyan YENİ bir API yöntemine sahiptir. Kullanımdan kaldırma planını ve v4 reportInsights API yönteminden Google Business Profile Performance API'ye geçiş talimatlarını inceleyin.
GoogleLocations API, bir konum için İşletme Profili'nde hak talebinde bulunulup bulunulmadığını önceden görmenize olanak tanır. Bu sayede, konum için hak talebinde bulunulmuşsa hemen konuma erişim isteğinde bulunabilirsiniz. Ayrıca, toplu olarak doğrulanmış hesapları yönetiyorsanız olası eşleşmeleri önceden daha doğru seçebilir ve yinelenen konumların oluşturulmasını önleyebilirsiniz.
API uç noktası, bir konum için hak talebinde bulunulup bulunulmadığını belirten bir URL döndürür. Hak talebinde bulunulmuşsa aynı URL, erişim isteği sürecini başlatmanıza olanak tanır.
Aşağıdaki resimde, bir konumun sahipliğini alma sürecine genel bir bakış sunulmaktadır.
Şekil 1. İşletme Profili yer sahipliğinin akış şeması
Aşağıdaki adımlar, GoogleLocations API'sini kullanmanıza olanak tanır:
Satıcıdan konum verilerini toplayın.
googleLocations.search
uç noktasını arayın. Konum verilerini aramanın gövdesinde sağlayın. Alternatif olarak, kullanıcının Arama veya Haritalar'da gireceğine benzer şekilde bir sorgu dizesinde de sağlayabilirsiniz. Örneğin,
"Starbucks 5th ave NYC."
API, eşleşme olasılığı olan konumların listesini ve her konumla ilgili bilgileri (ör. locationName ve adres) döndürür.
Yanıtta requestAdminRightsUrl değerinin durumuna göre aşağıdaki işlemleri yapın:
requestAdminRightsUrl varsa girişin sahibi başka bir kullanıcıdır.
Satıcıyı, İşletme Profili'ndeki mevcut konuma erişim ve sahiplik isteği başlatmak için URL'ye yönlendirin.
requestAdminRightsUrl yoksa accounts.locations.create işlevini çağırın ve daha sonra doğrulanacak yeni bir giriş oluşturun.
Bu süreç kapsamında yeni girişler oluşturduysanız girişlerin doğrulamasını başlatmak için doğrulama API'lerini kullanabilirsiniz. Daha fazla bilgi için Doğrulamayı yönetme başlıklı makaleyi inceleyin.
[null,null,["Son güncelleme tarihi: 2025-01-29 UTC."],[[["The GoogleLocations API helps determine if a Business Profile location has been claimed, allowing for access requests or creation of new listings."],["Use the API to search for existing locations, initiate access requests if claimed, or create new listings if unclaimed."],["If a new listing is created, leverage verification APIs to complete the setup process."],["This API is intended for managing locations with existing business relationships and should not be used for lead generation or competitive analysis."]]],["The GoogleLocations API determines if a location is claimed in Business Profile. Using the `googleLocations.search` endpoint, provide location data to find matching locations. If a match exists, check `requestAdminRightsUrl`; if present, initiate an access request via the provided URL. If not, or if no match is found, create a new location with `accounts.locations.create`. New listings require verification through the verification APIs. This API is for merchants with business relationships, not lead generation.\n"]]
