locations

POST /v1/locations/{locationsId}/placeActionLinks

Creates a place action link associated with the specified location, and returns it. The request is considered duplicate if the parent, place_action_link.uri and place_action_link.place_action_type are the same as a previous request.

Request

  • Base URL
    https://mybusinessplaceactions.googleapis.com
  • Auth
    none declared

Path parameters

locationsIdstring required

Request body

createTimestring google-datetime

Output only. The time when the place action link was created.

isEditableboolean

Output only. Indicates whether this link can be edited by the client.

isPreferredboolean

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.

namestring

Optional. The resource name, in the format locations/{location_id}/placeActionLinks/{place_action_link_id}. The name field will only be considered in UpdatePlaceActionLink and DeletePlaceActionLink requests for updating and deleting links respectively. However, it will be ignored in CreatePlaceActionLink 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.

placeActionType'PLACE_ACTION_TYPE_UNSPECIFIED' | 'APPOINTMENT' | 'ONLINE_APPOINTMENT' | 'DINING_RESERVATION' | 'FOOD_ORDERING' | 'FOOD_DELIVERY' | 'FOOD_TAKEOUT' | 'SHOP_ONLINE' | 'SOLOPRENEUR_APPOINTMENT'

Required. The type of place action that can be performed using this link.

providerType'PROVIDER_TYPE_UNSPECIFIED' | 'MERCHANT' | 'AGGREGATOR_3P'

Output only. Specifies the provider type.

updateTimestring google-datetime

Output only. The time when the place action link was last modified.

uristring

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).

Response

Successful response

createTimestring google-datetime

Output only. The time when the place action link was created.

isEditableboolean

Output only. Indicates whether this link can be edited by the client.

isPreferredboolean

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.

namestring

Optional. The resource name, in the format locations/{location_id}/placeActionLinks/{place_action_link_id}. The name field will only be considered in UpdatePlaceActionLink and DeletePlaceActionLink requests for updating and deleting links respectively. However, it will be ignored in CreatePlaceActionLink 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.

placeActionType'PLACE_ACTION_TYPE_UNSPECIFIED' | 'APPOINTMENT' | 'ONLINE_APPOINTMENT' | 'DINING_RESERVATION' | 'FOOD_ORDERING' | 'FOOD_DELIVERY' | 'FOOD_TAKEOUT' | 'SHOP_ONLINE' | 'SOLOPRENEUR_APPOINTMENT'

Required. The type of place action that can be performed using this link.

providerType'PROVIDER_TYPE_UNSPECIFIED' | 'MERCHANT' | 'AGGREGATOR_3P'

Output only. Specifies the provider type.

updateTimestring google-datetime

Output only. The time when the place action link was last modified.

uristring

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).

Changes

No recorded changes to this operation across all 3 revisions of this API.