Google Business Performance API มีเมธอด API
ใหม่ที่อนุญาตให้ดึง `DailyMetrics` หลายรายการในคําขอ API รายการเดียว
ตรวจสอบ
กําหนดการเลิกใช้งานและวิธีการย้ายข้อมูลจากเมธอด v4 reportInsights API ไปยัง API ประสิทธิภาพของ Google Business Profile
Method: accounts.listRecommendGoogleLocations
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
แสดงรายการ GoogleLocation ทั้งหมดที่แนะนำสำหรับบัญชี Business Profile ที่ระบุ คําแนะนํามีให้สําหรับบัญชีส่วนตัวและกลุ่มสถานที่ตั้งเท่านั้น คําขอสําหรับบัญชีประเภทอื่นๆ ทั้งหมดจะเกิดข้อผิดพลาด คำแนะนำสำหรับกลุ่มสถานที่ตั้งจะขึ้นอยู่กับสถานที่ตั้งในกลุ่มนั้น
คำแนะนำสำหรับบัญชีส่วนบุคคลจะอิงตามสถานที่ทั้งหมดที่ผู้ใช้มีสิทธิ์เข้าถึงใน Business Profile (ซึ่งรวมถึงสถานที่ที่ผู้ใช้เข้าถึงได้ผ่านกลุ่มสถานที่ตั้ง) และเป็นชุดหลักของคำแนะนำทั้งหมดที่สร้างขึ้นสำหรับผู้ใช้
คำขอ HTTP
GET https://mybusiness.googleapis.com/v4/{name=accounts/*}:recommendGoogleLocations
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
| พารามิเตอร์ |
name |
string
ชื่อทรัพยากรบัญชีที่ต้องการดึงข้อมูลสถานที่ของ Google ที่แนะนำ
|
พารามิเตอร์การค้นหา
| พารามิเตอร์ |
pageSize |
integer
จำนวนสถานที่ที่จะดึงข้อมูลต่อ 1 หน้า ค่าเริ่มต้นคือ 25, ต่ำสุดคือ 1 และขนาดหน้าเว็บสูงสุดคือ 100
|
pageToken |
string
หากระบุไว้ ระบบจะดึงข้อมูลหน้าถัดไปของสถานที่ตั้ง
|
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
ข้อความตอบกลับสำหรับ GoogleLocations.ListFeaturedGoogleLocations
นอกจากนี้ยังมีสถานที่บางแห่งที่ผู้ใช้ Business Profile รายอื่นๆ ได้อ้างสิทธิ์ไว้ตั้งแต่ครั้งล่าสุดที่ระบบแนะนำสถานที่เหล่านั้นกับบัญชี Business Profile นี้
| การแสดง JSON |
{
"googleLocations": [
{
object (GoogleLocation)
}
],
"totalSize": integer,
"nextPageToken": string
} |
| ช่อง |
googleLocations[] |
object (GoogleLocation)
สถานที่ที่แนะนำสำหรับบัญชี Business Profile แต่ละรูปแสดงถึง GoogleLocation ที่มีอยู่ใน Maps โดยสถานที่ตั้งจะจัดเรียงตามความเกี่ยวข้องกับบัญชี Business Profile จากมากไปน้อย
|
totalSize |
integer
จํานวนสถานที่ตั้งที่แนะนําทั้งหมดสําหรับบัญชี Business Profile นี้ โดยไม่คำนึงถึงการใส่เลขหน้า
|
nextPageToken |
string
ในระหว่างการใส่เลขหน้า หากมีสถานที่ที่จะดึงข้อมูลในหน้าถัดไปเพิ่มเติม ช่องนี้จะมีโทเค็นให้ดึงข้อมูลหน้าถัดไปของสถานที่ต่างๆ ในการโทรครั้งถัดไป หากไม่มีตำแหน่งที่จะดึงข้อมูลเพิ่มเติม ช่องนี้จะไม่ปรากฏในการตอบกลับ
|
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้
https://www.googleapis.com/auth/plus.business.managehttps://www.googleapis.com/auth/business.manage
สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-08-29 UTC
[null,null,["อัปเดตล่าสุด 2025-08-29 UTC"],[[["\u003cp\u003eLists recommended Google Locations for a specified Business Profile account, suitable for personal accounts and location groups.\u003c/p\u003e\n"],["\u003cp\u003eRecommendations are based on locations the user has access to and are sorted by relevance.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes location details, total recommendations, and pagination token for accessing further results.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with specific OAuth scopes for Business Profile management.\u003c/p\u003e\n"]]],[],null,["# Method: accounts.listRecommendGoogleLocations\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListRecommendedGoogleLocationsResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n\nList all the [GoogleLocation](/my-business/reference/rest/v4/googleLocations#GoogleLocation)s that have been recommended to the specified Business Profile account. Recommendations are provided for personal accounts and location groups only, requests for all other account types will result in an error. The recommendations for location groups are based on the locations in that group.\n\nThe recommendations for personal accounts are based on all of the locations that the user has access to on Business Profile (which includes locations they can access through location groups), and is a superset of all recommendations generated for the user.\n\n### HTTP request\n\n`GET https://mybusiness.googleapis.com/v4/{name=accounts/*}:recommendGoogleLocations`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|----------------------------------------------------------------------------------|\n| `name` | `string` Name of the account resource to fetch recommended Google locations for. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` How many locations to fetch per page. Default is 25, minimum is 1, and maximum page size is 100. |\n| `pageToken` | `string` If specified, the next page of locations is retrieved. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\nResponse message for GoogleLocations.ListRecommendedGoogleLocations.\n\nIt also contains some locations that have been claimed by other Business Profile users since the last time they were recommended to this Business Profile account.\n\n| JSON representation ||\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"googleLocations\": [ { object (/my-business/reference/rest/v4/googleLocations#GoogleLocation) } ], \"totalSize\": integer, \"nextPageToken\": string } ``` |\n\n| Fields ||\n|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `googleLocations[]` | `object (`[GoogleLocation](/my-business/reference/rest/v4/googleLocations#GoogleLocation)`)` The locations recommended to a Business Profile account. Each of these represents a [GoogleLocation](/my-business/reference/rest/v4/googleLocations#GoogleLocation) that is present on Maps. The locations are sorted in decreasing order of relevance to the Business Profile account. |\n| `totalSize` | `integer` The total number of recommended locations for this Business Profile account, irrespective of pagination. |\n| `nextPageToken` | `string` During pagination, if there are more locations available to be fetched in the next page, this field is populated with a token to fetch the next page of locations in a subsequent call. If there are no more locations to be fetched, this field is not present in the response. |\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)."]]
