Google Business Performance API یک روش API
جدید دارد که امکان واکشی چندین «DailyMetrics» را در یک درخواست API فراهم می‌کند.
زمان‌بندی منسوخ شدن و دستورالعمل‌های انتقال از روش API reportInsights v4 به API عملکرد نمایه کسب‌وکار Google را مرور کنید.
REST Resource: locations.placeActionLinks
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
منبع: PlaceActionLink
نشان دهنده پیوند عمل مکان و ویژگی های آن است.
| نمایندگی JSON |
|---|
{
"name": string,
"providerType": enum (ProviderType),
"isEditable": boolean,
"uri": string,
"placeActionType": enum (PlaceActionType),
"isPreferred": boolean,
"createTime": string,
"updateTime": string
} |
| فیلدها |
|---|
name | string اختیاری. نام منبع، در قالب locations/{locationId}/placeActionLinks/{place_action_link_id} . فیلد نام فقط در درخواست‌های placeActionLinks.patch و placeActionLinks.delete برای به‌روزرسانی و حذف پیوندها در نظر گرفته می‌شود. با این حال، در درخواست placeActionLinks.create نادیده گرفته می شود، جایی که place_action_link_id توسط سرور با ایجاد موفقیت آمیز پیوند جدید اختصاص داده می شود و به عنوان بخشی از پاسخ بازگردانده می شود. |
providerType | enum ( ProviderType ) فقط خروجی نوع ارائه دهنده را مشخص می کند. |
isEditable | boolean فقط خروجی نشان می دهد که آیا این پیوند توسط مشتری قابل ویرایش است یا خیر. |
uri | string مورد نیاز. لینک uri. یک uri یکسان را می توان برای انواع عملکردهای مختلف در مکان های مختلف مورد استفاده مجدد قرار داد. با این حال، تنها یک پیوند اقدام مکان برای هر ترکیب منحصربه‌فرد از (اوری، نوع عمل مکان، مکان) مجاز است. |
placeActionType | enum ( PlaceActionType ) مورد نیاز. نوع عمل مکان که می توان با استفاده از این لینک انجام داد. |
isPreferred | boolean اختیاری. آیا این پیوند توسط تاجر ترجیح داده می شود. فقط یک پیوند را می‌توان به‌عنوان ترجیحی در هر نوع اقدام مکان در یک مکان علامت‌گذاری کرد. اگر یک درخواست آینده پیوند دیگری را به عنوان ترجیحی برای همان نوع اقدام مکان علامت‌گذاری کند، پیوند ترجیحی فعلی (در صورت وجود) اولویت خود را از دست خواهد داد. |
createTime | string ( Timestamp format) فقط خروجی زمانی که لینک اکشن مکان ایجاد شد. مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" . |
updateTime | string ( Timestamp format) فقط خروجی زمانی که پیوند اکشن مکان آخرین بار اصلاح شد. مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" . |
نوع ارائه دهنده
نوع ارائه دهنده پیوند، فقط قابل خواندن است.
| Enums |
|---|
PROVIDER_TYPE_UNSPECIFIED | مشخص نشده است. |
MERCHANT | یک ارائه دهنده 1P مانند یک تاجر یا یک آژانس از طرف یک تاجر. |
AGGREGATOR_3P | یک جمع‌کننده 3P، مانند یک شریک Reserve with Google . |
PlaceActionType
نوع عمل مکانی که می توان با استفاده از پیوند انجام داد.
| Enums |
|---|
PLACE_ACTION_TYPE_UNSPECIFIED | مشخص نشده است. |
APPOINTMENT | نوع اقدام، رزرو قرار است. |
ONLINE_APPOINTMENT | نوع اقدام رزرو یک قرار آنلاین است. |
DINING_RESERVATION | نوع عمل، رزرو ناهارخوری است. |
FOOD_ORDERING | نوع اقدام، سفارش غذا برای تحویل و/یا بیرون بردن است. |
FOOD_DELIVERY | نوع عمل سفارش غذا برای تحویل است. |
FOOD_TAKEOUT | نوع عمل، سفارش غذا برای بیرون بردن است. |
SHOP_ONLINE | نوع اقدام خرید است که می تواند تحویل و/یا تحویل گرفتن باشد. |
روش ها |
|---|
| یک پیوند اقدام مکان مرتبط با مکان مشخص شده ایجاد می کند و آن را برمی گرداند. |
| پیوند اقدام مکان را از مکان مشخص شده حذف می کند. |
| پیوند اقدام مکان مشخص شده را دریافت می کند. |
| پیوندهای عمل مکان را برای مکان مشخص شده فهرست می کند. |
| پیوند عمل مکان مشخص شده را به روز می کند و آن را برمی گرداند. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003e\u003ccode\u003ePlaceActionLink\u003c/code\u003e resource represents a link associated with a Google Business Profile location, allowing customers to take actions like booking appointments or ordering food.\u003c/p\u003e\n"],["\u003cp\u003eLinks are categorized by \u003ccode\u003eProviderType\u003c/code\u003e (merchant, aggregator) and \u003ccode\u003ePlaceActionType\u003c/code\u003e (appointment, order, etc.) and can be managed through create, delete, get, list, and patch methods.\u003c/p\u003e\n"],["\u003cp\u003eEach link has attributes like \u003ccode\u003euri\u003c/code\u003e, \u003ccode\u003eisEditable\u003c/code\u003e, and \u003ccode\u003eisPreferred\u003c/code\u003e, providing control and information about the link's behavior and status.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ePlaceActionLink\u003c/code\u003e includes timestamps for creation and updates (\u003ccode\u003ecreateTime\u003c/code\u003e, \u003ccode\u003eupdateTime\u003c/code\u003e) enabling tracking of link history.\u003c/p\u003e\n"]]],[],null,["# REST Resource: locations.placeActionLinks\n\n- [Resource: PlaceActionLink](#PlaceActionLink)\n - [JSON representation](#PlaceActionLink.SCHEMA_REPRESENTATION)\n- [ProviderType](#ProviderType)\n- [PlaceActionType](#PlaceActionType)\n- [Methods](#METHODS_SUMMARY)\n\nResource: PlaceActionLink\n-------------------------\n\nRepresents a place action link and its attributes.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"providerType\": enum (/my-business/reference/placeactions/rest/v1/locations.placeActionLinks#ProviderType), \"isEditable\": boolean, \"uri\": string, \"placeActionType\": enum (/my-business/reference/placeactions/rest/v1/locations.placeActionLinks#PlaceActionType), \"isPreferred\": boolean, \"createTime\": string, \"updateTime\": string } ``` |\n\n| Fields ||\n|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Optional. The resource name, in the format `locations/{locationId}/placeActionLinks/{place_action_link_id}`. The name field will only be considered in placeActionLinks.patch and placeActionLinks.delete requests for updating and deleting links respectively. However, it will be ignored in placeActionLinks.create request, where `place_action_link_id` will be assigned by the server on successful creation of a new link and returned as part of the response. |\n| `providerType` | `enum (`[ProviderType](/my-business/reference/placeactions/rest/v1/locations.placeActionLinks#ProviderType)`)` Output only. Specifies the provider type. |\n| `isEditable` | `boolean` Output only. Indicates whether this link can be edited by the client. |\n| `uri` | `string` Required. The link uri. The same uri can be reused for different action types across different locations. However, only one place action link is allowed for each unique combination of (uri, place action type, location). |\n| `placeActionType` | `enum (`[PlaceActionType](/my-business/reference/placeactions/rest/v1/locations.placeActionLinks#PlaceActionType)`)` Required. The type of place action that can be performed using this link. |\n| `isPreferred` | `boolean` Optional. Whether this link is preferred by the merchant. Only one link can be marked as preferred per place action type at a location. If a future request marks a different link as preferred for the same place action type, then the current preferred link (if any exists) will lose its preference. |\n| `createTime` | `string (`[Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)` format)` Output only. The time when the place action link was created. A timestamp in RFC3339 UTC \"Zulu\" format, with nanosecond resolution and up to nine fractional digits. Examples: `\"2014-10-02T15:01:23Z\"` and `\"2014-10-02T15:01:23.045123456Z\"`. |\n| `updateTime` | `string (`[Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)` format)` Output only. The time when the place action link was last modified. A timestamp in RFC3339 UTC \"Zulu\" format, with nanosecond resolution and up to nine fractional digits. Examples: `\"2014-10-02T15:01:23Z\"` and `\"2014-10-02T15:01:23.045123456Z\"`. |\n\nProviderType\n------------\n\nThe type of the link provider, can only be read.\n\n| Enums ||\n|-----------------------------|-------------------------------------------------------------------------|\n| `PROVIDER_TYPE_UNSPECIFIED` | Not specified. |\n| `MERCHANT` | A 1P provider such as a merchant, or an agency on behalf of a merchant. |\n| `AGGREGATOR_3P` | A 3P aggregator, such as a `Reserve with Google` partner. |\n\nPlaceActionType\n---------------\n\nThe type of place action that can be performed using the link.\n\n| Enums ||\n|---------------------------------|------------------------------------------------------------------|\n| `PLACE_ACTION_TYPE_UNSPECIFIED` | Not specified. |\n| `APPOINTMENT` | The action type is booking an appointment. |\n| `ONLINE_APPOINTMENT` | The action type is booking an online appointment. |\n| `DINING_RESERVATION` | The action type is making a dining reservation. |\n| `FOOD_ORDERING` | The action type is ordering food for delivery and/or takeout. |\n| `FOOD_DELIVERY` | The action type is ordering food for delivery. |\n| `FOOD_TAKEOUT` | The action type is ordering food for takeout. |\n| `SHOP_ONLINE` | The action type is shopping, that can be delivery and/or pickup. |\n\n| Methods ------- ||\n|---------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|\n| ### [create](/my-business/reference/placeactions/rest/v1/locations.placeActionLinks/create) | Creates a place action link associated with the specified location, and returns it. |\n| ### [delete](/my-business/reference/placeactions/rest/v1/locations.placeActionLinks/delete) | Deletes a place action link from the specified location. |\n| ### [get](/my-business/reference/placeactions/rest/v1/locations.placeActionLinks/get) | Gets the specified place action link. |\n| ### [list](/my-business/reference/placeactions/rest/v1/locations.placeActionLinks/list) | Lists the place action links for the specified location. |\n| ### [patch](/my-business/reference/placeactions/rest/v1/locations.placeActionLinks/patch) | Updates the specified place action link and returns it. |"]]
