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 «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" . |
updateTime | string ( Timestamp format) Только вывод. Время последнего изменения ссылки на действие с местом. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" . |
ТипПровидера
Тип поставщика ссылок доступен только для чтения.
| Перечисления |
|---|
PROVIDER_TYPE_UNSPECIFIED | Не указан. |
MERCHANT | Поставщик 1P, например продавец или агентство от имени продавца. |
AGGREGATOR_3P | 3P-агрегатор, например Reserve with Google . |
ТипПлейсДейшнТип
Тип действия с местом, которое можно выполнить по ссылке.
| Перечисления |
|---|
PLACE_ACTION_TYPE_UNSPECIFIED | Не указан. |
APPOINTMENT | Тип действия — запись на прием. |
ONLINE_APPOINTMENT | Тип действия — запись на прием онлайн. |
DINING_RESERVATION | Тип действия — бронирование столика в ресторане. |
FOOD_ORDERING | Тип действия — заказ еды на доставку и/или на вынос. |
FOOD_DELIVERY | Тип действия — заказ еды на доставку. |
FOOD_TAKEOUT | Тип действия — заказ еды на вынос. |
SHOP_ONLINE | Тип действия — покупка, которая может быть доставкой и/или самовывозом. |
Методы |
|---|
| Создает ссылку действия места, связанную с указанным местоположением, и возвращает ее. |
| Удаляет ссылку на действие с местом из указанного места. |
| Получает ссылку на действие указанного места. |
| Перечисляет ссылки на действия места для указанного местоположения. |
| Обновляет указанную ссылку действия места и возвращает ее. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-25 UTC.
[null,null,["Последнее обновление: 2025-07-25 UTC."],[[["\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. |"]]
