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.
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Listeleme yönetimini doğrudan platformlarında sunan sağlayıcılar, satıcıların işletmelerini kendi sitelerinde doğrulayabilir. Bu sayede satıcının İşletme Profili kullanıcı arayüzüne yönlendirilmesine gerek kalmaz.
Geçerli durumu alma
Kullanıcılar, mevcut durumu almak için bir konumu locations.getVoiceOfMerchantState arayabilir. hasVoiceOfMerchanttrue değeri true ise konum zaten iyi durumda olduğundan ek bir işlem yapılması gerekmez. Aksi takdirde, yanıttaki gain_voice_of_merchant işlemi verify içeriyorsa doğrulama işlemini tamamlamanız gerekir. Daha fazla bilgi için aşağıdaki talimatları uygulayın.
Doğrulama seçeneklerini getirmek için aşağıdakileri kullanın:
HTTP
POST
https://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions
{
"languageCode": "en"
}
Doğrulama sürecini başlatma
Bir doğrulama yöntemi seçtikten sonra locations.verify ile doğrulama sürecini başlatın.
Bu görüşme sonucunda konum, doğrulanmış duruma geçer veya hata durumu döndürülür.
HTTP
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
:verify
// Use only one of the below verification methods
// For postcard verification:
{
"method": "ADDRESS",
"languageCode": "en",
"addressInput": {
"mailerContactName": "Ann Droyd"
}
}
// For phone verification:
{
"method": "PHONE_CALL",
"languageCode": "en",
"phoneInput": {
"phoneNumber": "800-555-0136"
}
}
// For SMS verification:
{
"method": "SMS",
"languageCode": "en",
"phoneInput": {
"phoneNumber": "800-555-0136"
}
}
// For email verification:
{
"method": "EMAIL",
"languageCode": "en",
"emailInput": {
"emailAddress": "ex@google.com"
}
}
Mevcut doğrulamaları alma
locations.verifications.list
çağrısı, doğrulama isteklerinin geçmişini ve çağrıda belirtilen konumun durumunu alır.
Tüm doğrulama isteklerini almak için aşağıdakileri kullanın:
HTTP
GET
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications
Bekleyen bir doğrulamayı tamamlamak için aşağıdakileri kullanın:
HTTP
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications/{verificationId}:complete
{
"pin": "123456"
}
API kullanarak GİP doğrulama için en iyi uygulamalar
Konum oluşturma
GBP İşletme Bilgileri API'si ile platformunuzu yerleştirerek konum oluşturma işlevi sağlayabilirsiniz. Satıcılardan yeni bir konum eklemelerini istediğinizde aşağıdaki adımları uyguladığınızdan emin olun:
Satıcıdan işletme adı, adres ve kategori gibi konum bilgilerini toplar.
API isteğinde işletme adı, kategori, adres, telefon numarası ve web sitesi gibi konum verilerini sağlayın.
Alternatif olarak, aşağıdaki adımları uygulayarak olası eşleşen konum için arama yapın:
Olası konum eşleşmelerini sorgulayın.
Satıcıdan doğru konumu seçmesini isteyin.
Konum yanıtında requestAdminRightsUrl varsa satıcının Google İşletme Profili'nde bu konum için erişim ve sahiplik isteğinde bulunmasına yardımcı olun.
requestAdminRightsUrl yoksa konum yanıtındaki yer kimliğiyle yeni bir konum oluşturun.
Yeni konumu doğrulayın.
Not: İlk sorgunuzdan olası konum eşleşmesi almazsanız yeni bir konum oluşturmak için boş bir yer kimliği kullanın. Ardından, yeni konumu doğrulayın.
Yer doğrulama
GBP API'yi kullanarak doğrulama sürecini başlatmak için lütfen aşağıdaki adımları uygulayın:
Bir Google Hesabı'nın tüm konumlarını listelemek için accounts.locations.list yöntemini çağırın.
Doğrulanacak bir konum seçin.
Konumun doğrulanması gerekip gerekmediğini onaylamak için GetVoiceOfMerchant API yöntemini çağırın.
Yanıt doğrulama döndürürse bu konumun doğrulanması için kullanılabilecek yöntemlerin listesini almak üzere fetchVerificationOptions numaralı telefonu arayın.
verificationOption verilerinin doğru adres, telefon numarası ve e-posta adresini içerdiğinden emin olun.
Satıcı, mevcut en iyi doğrulama seçeneğini belirledikten sonra uygun doğrulamayı başlatmak için locations.verify yöntemini çağırır. Başlatma işleminin devam ettiğini onaylamak için locations.verifications.list. numaralı telefonu arayın.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-09-03 UTC."],[[["\u003cp\u003eProviders can directly verify merchant businesses on their platforms, eliminating the need for redirection to the Business Profile UI.\u003c/p\u003e\n"],["\u003cp\u003eVerification options include postcard, phone call, SMS, and email, and can be fetched using the \u003ccode\u003elocations.fetchVerificationOptions\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eLocation creation involves searching for existing locations or creating new ones, followed by initiating the verification process using the \u003ccode\u003elocations.verify\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eVerification status can be retrieved using the \u003ccode\u003elocations.getVoiceOfMerchantState\u003c/code\u003e and \u003ccode\u003elocations.verifications.list\u003c/code\u003e methods.\u003c/p\u003e\n"],["\u003cp\u003eCompleting verification may require a PIN code and using the \u003ccode\u003elocations.verifications.complete\u003c/code\u003e method.\u003c/p\u003e\n"]]],["Providers can verify merchants' businesses directly on their platform. To verify, first check the location's status using `locations.getVoiceOfMerchantState`. If verification is needed, use `locations.fetchVerificationOptions` to present verification methods. Initiate with `locations.verify`, choosing a method (postcard, phone, SMS, or email). Track requests with `locations.verifications.list` and complete pending ones with `locations.verifications.complete`, providing a PIN. New location creation involves using `googleLocations.search` or creating a new location with a blank ID, followed by the verification process.\n"],null,["Providers who offer listing management directly on their platform can verify a merchant's\nbusiness within their site. This eliminates the need to redirect the merchant into the\nBusiness Profile UI.\n\nGet current state\n\nUsers can call [`locations.getVoiceOfMerchantState`](/my-business/reference/verifications/rest/v1/locations/getVoiceOfMerchantState)\non a location to retrieve its current status. If the\n`hasVoiceOfMerchant`\nboolean is `true`, then the location is already in good standing and no additional action is required. Otherwise, if the `gain_voice_of_merchant` action in the response contains `verify`, you must complete verification. Follow the instructions below for more information.\n\nFetch verification options\n\nProviders can use the\n[`locations.fetchVerificationOptions`](/my-business/reference/verifications/rest/v1/locations/fetchVerificationOptions)\nmethod to prompt merchants to choose a preferred contact method from a list of available\n[verification methods](/my-business/reference/verifications/rest/v1/VerificationMethod).\n| **Note:** Verification methods vary due to language and regional differences.\n\nTo fetch the verification options, use the following:\nHTTP \n\n```\nPOST\nhttps://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions\n\n{\n \"languageCode\": \"en\"\n}\n\n```\n\nInitiate the verification process\n\nAfter you choose a verification method, initiate the verification process with\n[`locations.verify`](/my-business/reference/verifications/rest/v1/locations/verify).\nAs a result of this call, the location moves to a verified state or an error status is returned.\n| An attempt to verify a new location when a location already exists returns an error and might initiate the [ownership resolution](https://support.google.com/business/answer/4661508) process.\nHTTP \n\n```\nPOST\nhttps://mybusinessverifications.googleapis.com/v1/locations/{locationId}\n:verify\n\n// Use only one of the below verification methods\n\n// For postcard verification:\n{\n \"method\": \"ADDRESS\",\n \"languageCode\": \"en\",\n \"addressInput\": {\n \"mailerContactName\": \"Ann Droyd\"\n }\n}\n\n// For phone verification:\n{\n \"method\": \"PHONE_CALL\",\n \"languageCode\": \"en\",\n \"phoneInput\": {\n \"phoneNumber\": \"800-555-0136\"\n }\n}\n\n// For SMS verification:\n{\n \"method\": \"SMS\",\n \"languageCode\": \"en\",\n \"phoneInput\": {\n \"phoneNumber\": \"800-555-0136\"\n }\n}\n\n// For email verification:\n{\n \"method\": \"EMAIL\",\n \"languageCode\": \"en\",\n \"emailInput\": {\n \"emailAddress\": \"ex@google.com\"\n }\n}\n\n```\n\nRetrieve current verifications\n\nThe\n[`locations.verifications.list`](/my-business/reference/verifications/rest/v1/locations.verifications/list)\ncall retrieves the history of verification requests along with their status for the location specified in the call.\n\nTo retrieve all verification requests, use the following:\nHTTP \n\n```\nGET\nhttps://mybusinessverifications.googleapis.com/v1/locations/{locationId}\n/verifications\n\n```\n\nComplete a pending verification\n\nA PIN code and the\n[`locations.verifications.complete`](/my-business/reference/verifications/rest/v1/locations.verifications/complete)\nmethod is usually required to complete the verification of a business.\n\nTo complete a pending verification, use the following:\nHTTP \n\n```\nPOST\nhttps://mybusinessverifications.googleapis.com/v1/locations/{locationId}\n/verifications/{verificationId}:complete\n\n{\n \"pin\": \"123456\"\n}\n\n```\n\nBest practices for GBP verification using API\n\nLocation creation\n\nWith the GBP Business Information API, you can embed your platform to provide location creation functionality. When you ask merchants to add a new location, make sure to follow these steps:\n\nCollect location information such as business name, address, category from the merchant.\n\n1. Call the [`googleLocations.search`](https://developers.google.com/my-business/reference/businessinformation/rest/v1/googleLocations/search) endpoint.\n2. Provide location data, such as business name, category, address, phone number and website within the API request.\n\n\u003cbr /\u003e\n\nAlternatively, perform a search for potential matching location by following these steps:\n\n1. Query possible location matches.\n2. Ask the merchant to choose the correct location.\n3. If `requestAdminRightsUrl` exists in the location response, help the merchant request access and ownership for that location on Google Business Profile.\n4. If `requestAdminRightsUrl` doesn't exist, create a new location with the Place ID in the location response.\n5. Verify the new location.\n\n\u003cbr /\u003e\n\n**Note:** If you don't get any possible location matches from your initial query, use a blank Place ID to create a new location. Then, verify that new location.\n\nLocation verification\n\nTo start the verification process using the GBP API, please follow these steps:\n\n\n1. Call the [`accounts.locations.list`](https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations/list) method to list all locations for a Google Account.\n2. Select a location to verify.\n3. Call the [`GetVoiceOfMerchant`](https://developers.google.com/my-business/content/manage-verification#get-current-state) API method to confirm whether that location requires verification.\n4. If the response returns verify, call [`fetchVerificationOptions`](https://developers.google.com/my-business/content/manage-verification#fetch-options) to get a list of methods available to verify that location.\n5. Double-check that the `verificationOption` data includes the correct address, phone number and email address.\n6. After the mechant selects the best-available verification option, call the [`locations.verify`](https://developers.google.com/my-business/content/manage-verification#initiate-verification) method to initiate the appropriate verification. To confirm that the initiation is in progress, call the [`locations.verifications.list.`](https://developers.google.com/my-business/content/manage-verification#retrieve-current-verifications)\n7. Call the [`locations.verification.complete`](https://developers.google.com/my-business/content/manage-verification#complete-verification) method with the merchant's pin.\n8. Call the [`GetVoiceOfMerchant`](https://developers.google.com/my-business/reference/verifications/rest/v1/locations/getVoiceOfMerchantState) API method. If `HasVoiceOfMerchant = true`, you have successfully verified the location.\n\n\u003cbr /\u003e\n\n**Note:** If `AUTO` verification is available for the location, the merchant need not perform any verification steps\n\nFor further information on GBP verification, please refer to our [help center support article.](https://support.google.com/business/answer/7107242)"]]
