Google Business Performance API มีเมธอด API
ใหม่ที่อนุญาตให้ดึง `DailyMetrics` หลายรายการในคําขอ API รายการเดียว
ตรวจสอบ
กําหนดการเลิกใช้งานและวิธีการย้ายข้อมูลจากเมธอด v4 reportInsights API ไปยัง API ประสิทธิภาพของ Google Business Profile
Method: googleLocations.report
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
คำขอ HTTP
POST https://mybusiness.googleapis.com/v4/{name=googleLocations/*}:report
URL ใช้ไวยากรณ์การแปลง 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
ไม่บังคับ รหัส BCP 47 ของภาษาที่ใช้ใน reportReasonElaboration
|
ช่องการรวม report_reason เหตุผลที่ตำแหน่งนี้ได้รับการรายงาน โปรดระบุเหตุผล report_reason ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้ |
reportReasonBadLocation |
enum (BadLocationReason)
เหตุผลที่ผู้ใช้รายงานตำแหน่งนี้ เมื่อปัญหาเกี่ยวข้องกับสถานที่เอง
|
reportReasonBadRecommendation |
enum (BadRecommendationReason)
เหตุผลที่ผู้ใช้รายงานสถานที่นี้เมื่อพบปัญหาเกี่ยวกับคำแนะนำ รายงานนี้มีประโยชน์หากมีการแนะนําสถานที่ตั้งดังกล่าวให้กับบัญชี Business Profile
|
เนื้อหาการตอบกลับ
หากสำเร็จ เนื้อหาการตอบกลับจะว่างเปล่า
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้
https://www.googleapis.com/auth/plus.business.managehttps://www.googleapis.com/auth/business.manage
สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
BadLocationReason
ชุดของเหตุผลที่เป็นไปได้ในการรายงานตำแหน่งเมื่อมีปัญหาเกี่ยวกับคุณภาพของข้อมูลในสถานที่ตั้งนั้นๆ
| Enum |
BAD_LOCATION_REASON_UNSPECIFIED |
ไม่ได้ระบุ |
NOT_A_LOCATION |
ตำแหน่งที่แนะนำไม่ใช่ตำแหน่งจริง |
PERMANENTLY_CLOSED |
สถานที่ที่แนะนำปิดถาวรแล้ว |
DOES_NOT_EXIST |
ไม่มีตำแหน่งที่แนะนำ |
SPAM |
สถานที่ที่แนะนำเป็นสแปม ปลอม หรือไม่เหมาะสม |
NOT_A_BUSINESS |
ตำแหน่งที่แนะนำคือสถานที่หรือบ้านส่วนตัว |
MOVED |
ตำแหน่งที่แนะนำย้ายไปยังตำแหน่งที่ตั้งใหม่แล้ว ควรมี reportReasonElaboration ซึ่งระบุที่อยู่ใหม่ด้วย |
DUPLICATE |
สถานที่ที่แนะนำนี้ซ้ำกับสถานที่อื่น |
BadRecommendationReason
ชุดสาเหตุที่เป็นไปได้ในการรายงานสถานที่เมื่อมีปัญหาเกี่ยวกับคุณภาพของคําแนะนํา (เมื่อแนะนําสถานที่นี้ให้กับผู้ใช้)
| Enum |
BAD_RECOMMENDATION_REASON_UNSPECIFIED |
ไม่ได้ระบุ |
NOT_A_STORE_FRONT |
ตำแหน่งที่แนะนำไม่ใช่หน้าร้าน |
NOT_PART_OF_SUGGESTED_CHAIN |
สถานที่ที่แนะนำไม่ได้เป็นของเครือธุรกิจที่แนะนำใน chainDisplayName ในสถานที่ที่ส่งคืน ควรมี reportReasonElaboration ที่ระบุชื่อของเชนที่ถูกต้องด้วย |
IRRELEVANT |
ตำแหน่งที่แนะนำไม่เกี่ยวข้องกับผู้ใช้ ควรมี reportReasonElaboration ประกอบกับคำอธิบายว่าเหตุใดคำแนะนำจึงไม่เกี่ยวข้อง |
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-08-29 UTC
[null,null,["อัปเดตล่าสุด 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. |"]]
