Google Business Performance API memiliki metode API
BARU yang memungkinkan pengambilan beberapa `DailyMetrics` dalam satu permintaan API.
Tinjau
jadwal penghentian dan petunjuk untuk bermigrasi dari metode API reportInsights v4 ke Google Business Profile Performance API.
Method: googleLocations.report
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Permintaan HTTP
POST https://mybusiness.googleapis.com/v4/{name=googleLocations/*}:report
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter |
name |
string
Nama resource [GoogleLocation], dalam format googleLocations/{googleLocationId} .
|
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
{
"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 .
} |
Kolom |
locationGroupName |
string
Opsional. Nama resource grup lokasi yang dilaporkan untuk Lokasi Google, dalam format accounts/{accountId} .
|
reportReasonElaboration |
string
Opsional. Entri teks untuk menguraikan alasan pengguna melaporkan lokasi ini. Panjang maksimum adalah 512 karakter.
|
reportReasonLanguageCode |
string
Opsional. Kode bahasa BCP 47 yang digunakan di reportReasonElaboration .
|
Kolom union report_reason . Alasan lokasi ini dilaporkan. Alasan harus diberikan. report_reason hanya dapat berupa salah satu dari berikut: |
reportReasonBadLocation |
enum (BadLocationReason )
Alasan pengguna melaporkan lokasi ini saat masalah terjadi pada lokasi itu sendiri.
|
reportReasonBadRecommendation |
enum (BadRecommendationReason )
Alasan pengguna melaporkan lokasi ini jika masalahnya berkaitan dengan rekomendasi. Laporan ini berguna jika lokasi direkomendasikan ke akun Profil Bisnis.
|
Isi respons
Jika berhasil, isi respons akan kosong.
Cakupan Otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/plus.business.manage
https://www.googleapis.com/auth/business.manage
Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
BadLocationReason
Kumpulan kemungkinan alasan untuk melaporkan lokasi saat ada masalah dengan kualitas data di lokasi itu sendiri.
Enum |
BAD_LOCATION_REASON_UNSPECIFIED |
Tidak ditentukan. |
NOT_A_LOCATION |
Lokasi yang direkomendasikan bukan lokasi sebenarnya. |
PERMANENTLY_CLOSED |
Lokasi yang direkomendasikan sudah tutup permanen. |
DOES_NOT_EXIST |
Lokasi yang direkomendasikan tidak ada. |
SPAM |
Lokasi yang direkomendasikan adalah spam, palsu, atau menyinggung. |
NOT_A_BUSINESS |
Lokasi yang direkomendasikan adalah tempat atau rumah pribadi. |
MOVED |
Lokasi yang direkomendasikan telah pindah ke lokasi baru. Harus disertai dengan reportReasonElaboration yang menentukan alamat baru. |
DUPLICATE |
Lokasi yang direkomendasikan merupakan duplikat dari lokasi lain. |
BadRecommendationReason
Kumpulan kemungkinan alasan untuk melaporkan lokasi saat ada masalah dengan kualitas rekomendasi (saat lokasi ini direkomendasikan kepada pengguna).
Enum |
BAD_RECOMMENDATION_REASON_UNSPECIFIED |
Tidak ditentukan. |
NOT_A_STORE_FRONT |
Lokasi yang direkomendasikan bukan toko. |
NOT_PART_OF_SUGGESTED_CHAIN |
Lokasi yang direkomendasikan bukan milik jaringan yang disarankan di chainDisplayName pada lokasi yang ditampilkan. Harus disertai reportReasonElaboration yang menentukan nama rantai yang benar. |
IRRELEVANT |
Lokasi yang direkomendasikan tidak relevan bagi pengguna. Harus disertai reportReasonElaboration untuk alasan rekomendasi tidak relevan. |
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-29 UTC.
[null,null,["Terakhir diperbarui pada 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. |"]]