Google Business Performance API یک روش API
جدید دارد که امکان واکشی چندین «DailyMetrics» را در یک درخواست API فراهم می‌کند.
زمان‌بندی منسوخ شدن و دستورالعمل‌های انتقال از روش API reportInsights v4 به API عملکرد نمایه کسب‌وکار Google را مرور کنید.
Method: locations.placeActionLinks.list
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
پیوندهای عمل مکان را برای مکان مشخص شده فهرست می کند.
درخواست HTTP
GET https://mybusinessplaceactions.googleapis.com/v1/{parent=locations/*}/placeActionLinks
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
parent | string مورد نیاز. نام مکانی که پیوندهای اقدام مکان آن فهرست می شود. locations/{locationId} . |
پارامترهای پرس و جو
| پارامترها |
|---|
filter | string اختیاری. فیلتری که پیوندهای عمل مکان را برای بازگشت محدود می کند. پاسخ شامل ورودی هایی است که با فیلتر مطابقت دارند. ما فقط از فیلتر زیر پشتیبانی می کنیم: 1. placeActionType=XYZ که در آن XYZ یک PlaceActionType معتبر است. |
pageSize | integer اختیاری. تعداد پیوندهای عمل مکان برای بازگرداندن در هر صفحه. پیش فرض 10. حداقل 1 است. |
pageToken | string اختیاری. اگر مشخص شده باشد، صفحه بعدی پیوندهای اقدام مکان را برمی گرداند. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
پیام پاسخ برای PlaceActions.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 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده 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)."]]
