Method: accounts.merchantReviews.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
طلب HTTP
GET https://merchantapi.googleapis.com/reviews/v1beta/{parent=accounts/*}/merchantReviews
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات |
parent |
string
مطلوب. الحساب الذي تريد عرض مراجعات التجار فيه التنسيق: accounts/{account}
|
مَعلمات طلب البحث
المعلمات |
pageSize |
integer
اختيارية: الحد الأقصى لعدد مراجعات التجار التي سيتم عرضها يمكن أن تعرض الخدمة عددًا أقل من هذه القيمة. الحد الأقصى للقيمة هو 1000، ويتم تحويل القيم التي تزيد عن 1000 إلى 1000. إذا لم يتم تحديد عدد معيّن، يتم عرض الحد الأقصى لعدد المراجعات.
|
pageToken |
string
اختيارية: رمز مميّز للصفحة، تم تلقّيه من مكالمة merchantReviews.list سابقة قدِّم هذا المرجع لاسترداد الصفحة اللاحقة. عند تقسيم الصفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى merchantReviews.list مع الطلب الذي قدّم الرمز المميّز للصفحة.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
رسالة الردّ على طريقة ListMerchantsReview
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
{
"merchantReviews": [
{
object (MerchantReview )
}
],
"nextPageToken": string
} |
الحقول |
merchantReviews[] |
object (MerchantReview )
مراجعة التاجر.
|
nextPageToken |
string
الرمز المميّز لاسترداد الصفحة التالية من النتائج
|
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/content
لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-01-23 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-01-23 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eLists all merchant reviews for a specified account, displaying details like review content and ratings.\u003c/p\u003e\n"],["\u003cp\u003eAllows pagination to retrieve large sets of reviews using \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e parameters.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/content\u003c/code\u003e scope for access.\u003c/p\u003e\n"],["\u003cp\u003eResponses include a list of MerchantReview objects and a token for retrieving subsequent pages.\u003c/p\u003e\n"]]],[],null,["# Method: accounts.merchantReviews.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.ListMerchantReviewsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists merchant reviews.\n\n### HTTP request\n\n`GET https://merchantapi.googleapis.com/reviews/v1beta/{parent=accounts/*}/merchantReviews`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-----------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The account to list merchant reviews for. Format: accounts/{account} |\n\n### Query parameters\n\n| Parameters ||\n|-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Optional. The maximum number of merchant reviews to return. The service can return fewer than this value. The maximum value is 1000; values above 1000 are coerced to 1000. If unspecified, the maximum number of reviews is returned. |\n| `pageToken` | `string` Optional. A page token, received from a previous `merchantReviews.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `merchantReviews.list` must match the call that provided the page token. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for the `ListMerchantsReview` method.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"merchantReviews\": [ { object (/merchant/api/reference/rest/reviews_v1beta/accounts.merchantReviews#MerchantReview) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|---------------------|-----------------------------------------------------------------------------------------------------------------------------------------|\n| `merchantReviews[]` | `object (`[MerchantReview](/merchant/api/reference/rest/reviews_v1beta/accounts.merchantReviews#MerchantReview)`)` The merchant review. |\n| `nextPageToken` | `string` The token to retrieve the next page of results. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/content`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]