Google Business Performance API یک روش API
جدید دارد که امکان واکشی چندین «DailyMetrics» را در یک درخواست API فراهم می‌کند.
زمان‌بندی منسوخ شدن و دستورالعمل‌های انتقال از روش API reportInsights v4 به API عملکرد نمایه کسب‌وکار Google را مرور کنید.
Method: accounts.locations.reviews.list
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
فهرست صفحه بندی شده نظرات را برای مکان مشخص شده برمی گرداند. این عملیات تنها در صورتی معتبر است که مکان مشخص شده تأیید شود.
درخواست HTTP
GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/reviews
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
parent | string نام مکان برای واکشی نظرات. |
پارامترهای پرس و جو
| پارامترها |
|---|
pageSize | integer تعداد نظرات برای واکشی در هر صفحه. حداکثر pageSize 50 است. |
pageToken | string در صورت مشخص شدن، صفحه بعدی نظرات را واکشی می کند. |
orderBy | string فیلدی را برای مرتب سازی نظرات بر اساس مشخص می کند. اگر نامشخص باشد، ترتیب مرورهای بازگردانده شده به‌طور پیش‌فرض روی updateTime desc خواهد بود. سفارش‌های معتبر برای مرتب‌سازی عبارتند از: rating ، rating desc و updateTime desc . |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
پیام پاسخ برای Reviews.ListReviews.
| نمایندگی JSON |
|---|
{
"reviews": [
{
object (Review)
}
],
"averageRating": number,
"totalReviewCount": integer,
"nextPageToken": string
} |
| فیلدها |
|---|
reviews[] | object ( Review ) بررسی ها |
averageRating | number میانگین رتبه‌بندی ستاره همه نظرات برای این مکان در مقیاس 1 تا 5، که در آن 5 بالاترین رتبه است. |
totalReviewCount | integer تعداد کل نظرات برای این مکان. |
nextPageToken | string اگر تعداد بازبینی‌ها از اندازه صفحه درخواستی بیشتر باشد، این فیلد با رمزی پر می‌شود تا در تماس بعدی با reviews.list صفحه بعدی بررسی‌ها را واکشی کند. اگر نظر دیگری وجود نداشته باشد، این قسمت در پاسخ وجود ندارد. |
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/plus.business.manage -
https://www.googleapis.com/auth/business.manage
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eRetrieves a paginated list of reviews for a specified, verified Google My Business location.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by page size, page token, and sorting order (rating, rating descending, or update time descending).\u003c/p\u003e\n"],["\u003cp\u003eReturns review details, average rating, total review count, and a token for retrieving subsequent pages if available.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with specific OAuth scopes for business management.\u003c/p\u003e\n"]]],["This content outlines the process of retrieving a paginated list of reviews for a verified location using a `GET` request to a specific URL. The URL utilizes path parameters like `parent` to identify the location. Query parameters such as `pageSize`, `pageToken`, and `orderBy` are used to manage pagination and sorting. The request body is empty. A successful response returns a JSON object containing a list of `reviews`, `averageRating`, `totalReviewCount`, and optionally `nextPageToken` for pagination. Authorization requires specific OAuth scopes.\n"],null,["# Method: accounts.locations.reviews.list\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.ListReviewsResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n\nReturns the paginated list of reviews for the specified location. This operation is only valid if the specified location is verified.\n\n### HTTP request\n\n`GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/reviews`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|---------------------------------------------------------|\n| `parent` | `string` The name of the location to fetch reviews for. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` How many reviews to fetch per page. The maximum `pageSize` is 50. |\n| `pageToken` | `string` If specified, it fetches the next page of reviews. |\n| `orderBy` | `string` Specifies the field to sort reviews by. If unspecified, the order of reviews returned will default to `updateTime desc`. Valid orders to sort by are `rating`, `rating desc` and `updateTime desc`. |\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 Reviews.ListReviews.\n\n| JSON representation ||\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"reviews\": [ { object (/my-business/reference/rest/v4/accounts.locations.reviews#Review) } ], \"averageRating\": number, \"totalReviewCount\": integer, \"nextPageToken\": string } ``` |\n\n| Fields ||\n|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `reviews[]` | `object (`[Review](/my-business/reference/rest/v4/accounts.locations.reviews#Review)`)` The reviews. |\n| `averageRating` | `number` The average star rating of all reviews for this location on a scale of 1 to 5, where 5 is the highest rating. |\n| `totalReviewCount` | `integer` The total number of reviews for this location. |\n| `nextPageToken` | `string` If the number of reviews exceeded the requested page size, this field is populated with a token to fetch the next page of reviews on a subsequent call to reviews.list. If there are no more reviews, 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)."]]
