Google Business Performance API 的
NEW API 方法可擷取單一 API 要求中的多個「DailyMetrics」。
請詳閱
淘汰時間表和從 v4 reportInsights API 方法遷移至 Google Business Profile Performance API 的操作說明。
Method: googleLocations.report
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
HTTP 要求
POST https://mybusiness.googleapis.com/v4/{name=googleLocations/*}:report
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
name |
string
[GoogleLocation] 的資源名稱,格式為 googleLocations/{googleLocationId} 。
|
要求主體
要求主體的資料會採用以下結構:
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 .
} |
欄位 |
locationGroupName |
string
選用設定。系統回報這個 Google 地點的地區群組名稱,格式為 accounts/{accountId} 。
|
reportReasonElaboration |
string
選用設定。文字項目,說明使用者檢舉這個地點的原因。長度上限為 512 個半形字元。
|
reportReasonLanguageCode |
string
選用設定。reportReasonElaboration 中所用語言的 BCP 47 代碼。
|
聯集欄位 report_reason 。檢舉這個地點的原因。必須提供原因。report_reason 只能是下列其中一項: |
reportReasonBadLocation |
enum (BadLocationReason )
使用者回報的地點本身的問題。
|
reportReasonBadRecommendation |
enum (BadRecommendationReason )
使用者回報系統建議的問題時,回報這個位置。如果商家檔案帳戶中有推薦該地點,這份報表就非常實用。
|
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/plus.business.manage
https://www.googleapis.com/auth/business.manage
詳情請參閱 OAuth 2.0 總覽。
BadLocationReason
該地點本身的資料品質有問題時,可回報位置資訊的一組原因。
列舉 |
BAD_LOCATION_REASON_UNSPECIFIED |
不指定。 |
NOT_A_LOCATION |
建議位置實際上並非實際位置。 |
PERMANENTLY_CLOSED |
建議地點已永久停業。 |
DOES_NOT_EXIST |
建議的位置不存在。 |
SPAM |
建議的地點為垃圾內容、不實或令人反感的內容。 |
NOT_A_BUSINESS |
建議的地點為私人地點或住家。 |
MOVED |
建議位置已移至新位置。 應隨附用於指定新地址的 reportReasonElaboration 。 |
DUPLICATE |
建議的地點與其他地點重複。 |
BadRecommendationReason
建議的品質有問題時,回報位置資訊的一組可能原因 (使用者建議看到這個位置時)。
列舉 |
BAD_RECOMMENDATION_REASON_UNSPECIFIED |
不指定。 |
NOT_A_STORE_FRONT |
建議的地點不是店面。 |
NOT_PART_OF_SUGGESTED_CHAIN |
建議位置不屬於傳回位置 chainDisplayName 中建議的連鎖店。 應隨附的 reportReasonElaboration 指定正確鏈結名稱。 |
IRRELEVANT |
建議位置與使用者無關。 應隨附 reportReasonElaboration ,說明最佳化建議不相關的原因。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-29 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-08-29 (世界標準時間)。"],[[["\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,[]]