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.
Method: googleLocations.report
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
HTTP isteği
POST https://mybusiness.googleapis.com/v4/{name=googleLocations/*}:report
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
| Parametreler |
name |
string
[GoogleLocation] öğesinin googleLocations/{googleLocationId} biçimindeki kaynak adı.
|
İstek içeriği
İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:
| JSON gösterimi |
{
"locationGroupName": string,
"reportReasonElaboration": string,
"reportReasonLanguageCode": string,
// Union field report_reason can be only one of the following:
"reportReasonBadLocation": enum (BadLocationReason),
"reportReasonBadRecommendation": enum (BadRecommendationReason)
// End of list of possible types for union field report_reason.
} |
| Alanlar |
locationGroupName |
string
İsteğe bağlı. Bu Google Konumu'nun bildirildiği konum grubunun accounts/{accountId} biçimindeki kaynak adı.
|
reportReasonElaboration |
string
İsteğe bağlı. Kullanıcının bu konumu bildirme nedenini ayrıntılarıyla anlatan metin girişi. En çok 512 karakter kullanılabilir.
|
reportReasonLanguageCode |
string
İsteğe bağlı. reportReasonElaboration bölgesinde kullanılan BCP 47 dil kodu.
|
Birleştirme alanı report_reason. Bu konumun bildirilme nedeni. Bir neden belirtilmelidir. report_reason şunlardan yalnızca biri olabilir: |
reportReasonBadLocation |
enum (BadLocationReason)
Sorun konumun kendisiyle ilgili olduğunda, kullanıcının bu konumu bildirme nedeni.
|
reportReasonBadRecommendation |
enum (BadRecommendationReason)
Sorun öneriyle ilgili olduğunda kullanıcının bu konumu bildirme nedeni. Konum, İşletme Profili hesabına önerilmişse bu rapor yararlıdır.
|
Yanıt gövdesi
Başarılı olursa yanıt gövdesi boş olur.
Yetkilendirme Kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/plus.business.managehttps://www.googleapis.com/auth/business.manage
Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.
BadLocationReason
Konumun kendisindeki verilerin kalitesiyle ilgili bir sorun olduğunda, konumun bildirilmesi için bir dizi olası neden.
| Sıralamalar |
BAD_LOCATION_REASON_UNSPECIFIED |
Belirtilmedi. |
NOT_A_LOCATION |
Önerilen konum, gerçek bir konum değildir. |
PERMANENTLY_CLOSED |
Önerilen konum kalıcı olarak kapatıldı. |
DOES_NOT_EXIST |
Önerilen konum mevcut değil. |
SPAM |
Önerilen konum spam, sahte veya rahatsız edici. |
NOT_A_BUSINESS |
Önerilen konum, özel bir mülk veya evdir. |
MOVED |
Önerilen konum yeni bir konuma taşındı. Bununla birlikte, yeni adresi belirten bir reportReasonElaboration bulunmalıdır. |
DUPLICATE |
Önerilen konum, başka bir konumun kopyasıdır. |
BadRecommendationReason
Öneri kalitesinde sorun olduğunda (bu konum kullanıcıya önerildiğinde) konumun bildirilmesinin bir dizi olası nedeni.
| Sıralamalar |
BAD_RECOMMENDATION_REASON_UNSPECIFIED |
Belirtilmedi. |
NOT_A_STORE_FRONT |
Önerilen konum bir vitrin değil. |
NOT_PART_OF_SUGGESTED_CHAIN |
Önerilen konum, döndürülen konumdaki chainDisplayName özelliğinde önerilen zincire ait değil. Doğru zincirin adını belirten bir reportReasonElaboration ile birlikte kullanılmalıdır. |
IRRELEVANT |
Önerilen konum, kullanıcıyla alakalı değil. Önerinin neden alakasız olduğunu belirtmek için reportReasonElaboration ile birlikte gösterilmelidir. |
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-29 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-29 UTC."],[[["\u003cp\u003eReport a Google Location using the \u003ccode\u003egoogleLocations/{googleLocationId}\u003c/code\u003e resource name and specifying the report reason.\u003c/p\u003e\n"],["\u003cp\u003eProvide optional details like \u003ccode\u003elocationGroupName\u003c/code\u003e, \u003ccode\u003ereportReasonElaboration\u003c/code\u003e, and \u003ccode\u003ereportReasonLanguageCode\u003c/code\u003e for better context.\u003c/p\u003e\n"],["\u003cp\u003eReport reasons can be categorized as either related to the location itself (\u003ccode\u003eBadLocationReason\u003c/code\u003e) or to the recommendation (\u003ccode\u003eBadRecommendationReason\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires a JSON payload with details about the report, and a successful response results in an empty body.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required using either the \u003ccode\u003ehttps://www.googleapis.com/auth/plus.business.manage\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e OAuth scopes.\u003c/p\u003e\n"]]],["To report a Google Location, send a POST request to `https://mybusiness.googleapis.com/v4/{name=googleLocations/*}:report`, where `name` is the location's resource name. The request body should include `locationGroupName`, `reportReasonElaboration`, `reportReasonLanguageCode`, and a `report_reason`. The `report_reason` is either a `reportReasonBadLocation` or `reportReasonBadRecommendation` enum. Response body will be empty. This action requires `plus.business.manage` or `business.manage` OAuth scopes.\n"],null,["# Method: googleLocations.report\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization Scopes](#body.aspect)\n- [BadLocationReason](#BadLocationReason)\n- [BadRecommendationReason](#BadRecommendationReason)\n\nReport a [GoogleLocation](/my-business/reference/rest/v4/googleLocations#GoogleLocation).\n\n### HTTP request\n\n`POST https://mybusiness.googleapis.com/v4/{name=googleLocations/*}:report`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|-----------------------------------------------------------------------------------------------------|\n| `name` | `string` Resource name of a \\[GoogleLocation\\], in the format `googleLocations/{googleLocationId}`. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation ||\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"locationGroupName\": string, \"reportReasonElaboration\": string, \"reportReasonLanguageCode\": string, // Union field `report_reason` can be only one of the following: \"reportReasonBadLocation\": enum (/my-business/reference/rest/v4/googleLocations/report#BadLocationReason), \"reportReasonBadRecommendation\": enum (/my-business/reference/rest/v4/googleLocations/report#BadRecommendationReason) // End of list of possible types for union field `report_reason`. } ``` |\n\n| Fields ||\n|---------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| `locationGroupName` | `string` Optional. The resource name of the location group that this Google Location is being reported for, in the format `accounts/{accountId}`. |\n| `reportReasonElaboration` | `string` Optional. A text entry for elaborating on the reason for which the user is reporting this location. The maximum length is 512 characters. |\n| `reportReasonLanguageCode` | `string` Optional. The BCP 47 code of language used in `reportReasonElaboration`. |\n| Union field `report_reason`. Reason why this location is being reported. A reason must be provided. `report_reason` can be only one of the following: |||\n| `reportReasonBadLocation` | `enum (`[BadLocationReason](/my-business/reference/rest/v4/googleLocations/report#BadLocationReason)`)` The reason for which the user is reporting this location when the issue is with the location itself. |\n| `reportReasonBadRecommendation` | `enum (`[BadRecommendationReason](/my-business/reference/rest/v4/googleLocations/report#BadRecommendationReason)`)` The reason for which the user is reporting this location when the issue is with the recommendation. This report is useful if the location has been recommended to the Business Profile account. |\n\n### Response body\n\nIf successful, the response body is empty.\n\n### Authorization Scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/plus.business.manage`\n- `https://www.googleapis.com/auth/business.manage`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2).\n\nBadLocationReason\n-----------------\n\nA set of possible reasons for reporting a location when there is an issue with the quality of data in the location itself.\n\n| Enums ||\n|-----------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|\n| `BAD_LOCATION_REASON_UNSPECIFIED` | Not specified. |\n| `NOT_A_LOCATION` | The recommended location is not an actual location. |\n| `PERMANENTLY_CLOSED` | The recommended location is permanently closed. |\n| `DOES_NOT_EXIST` | The recommended location does not exist. |\n| `SPAM` | The recommended location is spam, fake or offensive. |\n| `NOT_A_BUSINESS` | The recommended location is a private place or home. |\n| `MOVED` | The recommended location has moved to a new location. Should be accompanied by a `reportReasonElaboration` specifying the new address. |\n| `DUPLICATE` | The recommended location is a duplicate of another location. |\n\nBadRecommendationReason\n-----------------------\n\nA set of possible reasons for reporting a location when there is an issue with the quality of recommendation (when this location is recommended to the user).\n\n| Enums ||\n|-----------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `BAD_RECOMMENDATION_REASON_UNSPECIFIED` | Not specified. |\n| `NOT_A_STORE_FRONT` | The recommended location is not a store front. |\n| `NOT_PART_OF_SUGGESTED_CHAIN` | The recommended location doesn't belong to the chain suggested in the `chainDisplayName` in the returned location. Should be accompanied by a `reportReasonElaboration` specifying the name of the correct chain. |\n| `IRRELEVANT` | The recommended location is not relevant to the user. Should be accompanied by a `reportReasonElaboration` for why the recommendation is irrelevant. |"]]
