REST Resource: locations.placeActionLinks
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tài nguyên: PlaceActionLink
Đại diện cho một đường liên kết đến hành động liên quan đến địa điểm và các thuộc tính của đường liên kết đó.
| Biểu diễn dưới dạng JSON |
{
"name": string,
"providerType": enum (ProviderType),
"isEditable": boolean,
"uri": string,
"placeActionType": enum (PlaceActionType),
"isPreferred": boolean,
"createTime": string,
"updateTime": string
} |
| Trường |
name |
string
Không bắt buộc. Tên tài nguyên, ở định dạng locations/{locationId}/placeActionLinks/{place_action_link_id}. Trường tên sẽ chỉ được xem xét trong các yêu cầu cập nhật và xoá đường liên kết tương ứng tại placeActionLinks.patch và placeActionLinks.delete. Tuy nhiên, yêu cầu này sẽ bị bỏ qua trong yêu cầu placeActionLinks.create, trong đó place_action_link_id sẽ được máy chủ chỉ định khi tạo thành công một đường liên kết mới và được trả về như một phần của phản hồi.
|
providerType |
enum (ProviderType)
Chỉ có đầu ra. Chỉ định loại nhà cung cấp.
|
isEditable |
boolean
Chỉ có đầu ra. Cho biết liệu khách hàng có thể chỉnh sửa đường liên kết này hay không.
|
uri |
string
Bắt buộc. URI đường liên kết. Bạn có thể sử dụng lại cùng một URI cho nhiều loại hành động trên nhiều vị trí. Tuy nhiên, chỉ được phép sử dụng một đường liên kết đến hành động liên quan đến địa điểm cho mỗi tổ hợp riêng biệt (uri, loại hành động liên quan đến địa điểm, vị trí).
|
placeActionType |
enum (PlaceActionType)
Bắt buộc. Loại hành động liên quan đến địa điểm mà bạn có thể thực hiện bằng cách sử dụng đường liên kết này.
|
isPreferred |
boolean
Không bắt buộc. Liệu người bán có ưu tiên đường liên kết này hay không. Bạn chỉ có thể đánh dấu một đường liên kết là ưu tiên cho mỗi loại hành động liên quan đến địa điểm tại một vị trí. Nếu một yêu cầu trong tương lai đánh dấu một đường liên kết khác là được ưu tiên cho cùng một loại hành động liên quan đến địa điểm, thì đường liên kết được ưu tiên hiện tại (nếu có) sẽ mất lựa chọn ưu tiên.
|
createTime |
string (Timestamp format)
Chỉ có đầu ra. Thời điểm đường liên kết đến hành động liên quan đến địa điểm được tạo. Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
|
updateTime |
string (Timestamp format)
Chỉ có đầu ra. Thời điểm sửa đổi lần gần đây nhất đường liên kết đến hành động liên quan đến địa điểm. Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
|
ProviderType
Chỉ có thể đọc loại nhà cung cấp đường liên kết.
| Enum |
PROVIDER_TYPE_UNSPECIFIED |
Chưa chỉ định. |
MERCHANT |
Nhà cung cấp bên thứ nhất, chẳng hạn như người bán hoặc đại lý thay mặt cho người bán. |
AGGREGATOR_3P |
Trang web tổng hợp của bên thứ ba, chẳng hạn như đối tác Reserve with Google. |
PlaceActionType
Loại hành động liên quan đến địa điểm mà bạn có thể thực hiện bằng cách sử dụng đường liên kết.
| Enum |
PLACE_ACTION_TYPE_UNSPECIFIED |
Chưa chỉ định. |
APPOINTMENT |
Loại hành động là đặt lịch hẹn. |
ONLINE_APPOINTMENT |
Loại hành động là đặt lịch hẹn trực tuyến. |
DINING_RESERVATION |
Loại hành động là đặt chỗ ăn tối. |
FOOD_ORDERING |
Loại hành động là đặt đồ ăn giao tận nơi và/hoặc mua mang đi. |
FOOD_DELIVERY |
Loại hành động là đặt đồ ăn giao tận nơi. |
FOOD_TAKEOUT |
Loại hành động là đặt đồ ăn mang đi. |
SHOP_ONLINE |
Loại hành động là mua sắm, có thể là giao hàng và/hoặc đến lấy hàng. |
Phương thức |
|
|
Tạo một liên kết hành động liên quan đến địa điểm được liên kết với vị trí được chỉ định và trả lại vị trí đó. |
|
|
Xoá một đường liên kết đến hành động liên quan đến địa điểm khỏi vị trí được chỉ định. |
|
|
Lấy đường liên kết đến hành động liên quan đến địa điểm được chỉ định. |
|
|
Liệt kê các đường liên kết đến hành động liên quan đến địa điểm cho địa điểm đã chỉ định. |
|
|
Cập nhật đường liên kết đến hành động liên quan đến địa điểm được chỉ định và trả lại đường liên kết đó. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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. |"]]
