تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
Method: accounts.locations.localPosts.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
عرض قائمة بالمشاركات المحلية المرتبطة بموقع جغرافي
طلب HTTP
GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/localPosts
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
parent |
string
اسم الموقع الجغرافي الذي سيتم إدراج مشاركاته المحلية
|
معامِلات طلب البحث
| المعلمات |
pageSize |
integer
عدد المشاركات المحلية التي يتم عرضها في كل صفحة. القيمة التلقائية هي 20. الحد الأدنى هو 1 والحد الأقصى لحجم الصفحة هو 100.
|
pageToken |
string
في حال تحديد هذا الخيار، سيتم عرض الصفحة التالية من المشاركات المحلية.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
رسالة ردّ لـ localPosts.list
| تمثيل JSON |
{
"localPosts": [
{
object (LocalPost)
}
],
"nextPageToken": string
} |
| الحقول |
localPosts[] |
object (LocalPost)
القائمة المعروضة للمشاركات المحلية.
|
nextPageToken |
string
إذا كان هناك مشاركات محلية أكثر من حجم الصفحة المطلوب، سيتم ملء هذا الحقل برمز مميّز لجلب الصفحة التالية من المشاركات المحلية عند استدعاء localPosts.list لاحقًا.
|
نطاقات التفويض
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/plus.business.managehttps://www.googleapis.com/auth/business.manage
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis endpoint retrieves a list of local posts associated with a specific location using an HTTP GET request.\u003c/p\u003e\n"],["\u003cp\u003eIt supports pagination with \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e query parameters, allowing control over the number of posts returned and retrieval of subsequent pages.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes an array of \u003ccode\u003eLocalPost\u003c/code\u003e objects and a \u003ccode\u003enextPageToken\u003c/code\u003e for accessing further results if available.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required with specific OAuth scopes such as \u003ccode\u003ehttps://www.googleapis.com/auth/plus.business.manage\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e.\u003c/p\u003e\n"]]],["This describes how to retrieve local posts associated with a specific location. A `GET` request is sent to the specified URL, including the location in the `parent` path parameter. Optional `pageSize` and `pageToken` query parameters allow for pagination. The request body must be empty. The successful response includes an array of `localPosts` objects, and a `nextPageToken` string for retrieving further results if more are available. Access requires specific authorization scopes.\n"],null,["# Method: accounts.locations.localPosts.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.ListLocalPostsResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n\nReturns a list of local posts associated with a location.\n\n### HTTP request\n\n`GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/localPosts`\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 whose local posts will be listed. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|-------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` How many local posts to return per page. Default of 20. The minimum is 1, and maximum page size is 100. |\n| `pageToken` | `string` If specified, returns the next page of local posts. |\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 localPosts.list\n\n| JSON representation ||\n|--------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"localPosts\": [ { object (/my-business/reference/rest/v4/accounts.locations.localPosts#LocalPost) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `localPosts[]` | `object (`[LocalPost](/my-business/reference/rest/v4/accounts.locations.localPosts#LocalPost)`)` The returned list of local posts. |\n| `nextPageToken` | `string` If there are more local posts than the requested page size, then this field is populated with a token to fetch the next page of local posts on a subsequent call to `localPosts.list`. |\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)."]]
