تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
Method: locations.placeActionLinks.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يسرد روابط إجراءات المكان للموقع الجغرافي المحدد.
طلب HTTP
GET https://mybusinessplaceactions.googleapis.com/v1/{parent=locations/*}/placeActionLinks
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
parent |
string
مطلوب. اسم الموقع الجغرافي الذي سيتم إدراج روابط الإجراءات المستندة إليه locations/{locationId}.
|
معامِلات طلب البحث
| المعلمات |
filter |
string
اختياريّ. فلتر يقيد روابط الإجراء المكاني من أجل عرضه. يتضمن الردّ إدخالات تُطابق الفلتر. نتيح استخدام الفلتر التالي فقط: 1. PlaceActionType=XYZ حيث يكون XYZ هو PlaceActionType صالح.
|
pageSize |
integer
اختياريّ. عدد روابط الإجراءات المستندة إلى المكان التي يمكن عرضها في كل صفحة القيمة التلقائية هي 10. الحد الأدنى هو 1.
|
pageToken |
string
اختياريّ. في حال تحديد هذه السمة، يتم عرض الصفحة التالية من روابط الإجراءات المستندة إلى المكان.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
رسالة ردّ على PlaceAction.ListPlaceActionLinks
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"placeActionLinks": [
{
object (PlaceActionLink)
}
],
"nextPageToken": string
} |
| الحقول |
placeActionLinks[] |
object (PlaceActionLink)
القائمة المعروضة بروابط الإجراءات المستندة إلى المكان
|
nextPageToken |
string
إذا كان عدد روابط الإجراءات المستندة إلى المكان أكبر من حجم الصفحة المطلوب، ستتم تعبئة هذا الحقل برمز مميّز لجلب الصفحة التالية من النتائج.
|
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://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\u003eLists place action links for a specified location using a GET request.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering results by place action type, pagination with page size and token.\u003c/p\u003e\n"],["\u003cp\u003eRequest body should be empty; the response includes an array of PlaceActionLinks and a nextPageToken for pagination.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],[],null,["# Method: locations.placeActionLinks.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.ListPlaceActionLinksResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nLists the place action links for the specified location.\n\n### HTTP request\n\n`GET https://mybusinessplaceactions.googleapis.com/v1/{parent=locations/*}/placeActionLinks`\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 name of the location whose place action links will be listed. `locations/{locationId}`. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `filter` | `string` Optional. A filter constraining the place action links to return. The response includes entries that match the filter. We support only the following filter: 1. placeActionType=XYZ where XYZ is a valid PlaceActionType. |\n| `pageSize` | `integer` Optional. How many place action links to return per page. Default of 10. The minimum is 1. |\n| `pageToken` | `string` Optional. If specified, returns the next page of place action links. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for PlaceActions.ListPlaceActionLinks.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"placeActionLinks\": [ { object (/my-business/reference/placeactions/rest/v1/locations.placeActionLinks#PlaceActionLink) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `placeActionLinks[]` | `object (`[PlaceActionLink](/my-business/reference/placeactions/rest/v1/locations.placeActionLinks#PlaceActionLink)`)` The returned list of place action links. |\n| `nextPageToken` | `string` If there are more place action links than the requested page size, then this field is populated with a token to fetch the next page of results. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\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)."]]
