# My Business Place Actions API . locations . placeActionLinks

## Instance Methods

Close httplib2 connections.

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.

Deletes a place action link from the specified location.

Gets the specified place action link.

Lists the place action links for the specified location.

Retrieves the next page of results.

Updates the specified place action link and returns it.

### Method Details

`close()`

    Close httplib2 connections.

`create(parent, body=None, x__xgafv=None)`

    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.

    Args:
      parent: string, Required. The resource name of the location where to create this place action link. `locations/{location_id}`. (required)
      body: object, The request body.
        The object takes the form of:

    { # Represents a place action link and its attributes.
      "createTime": "A String", # Output only. The time when the place action link was created.
      "isEditable": True or False, # Output only. Indicates whether this link can be edited by the client.
      "isPreferred": True or False, # 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.
      "name": "A String", # 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": "A String", # Required. The type of place action that can be performed using this link.
      "providerType": "A String", # Output only. Specifies the provider type.
      "updateTime": "A String", # Output only. The time when the place action link was last modified.
      "uri": "A 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).
    }

      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # Represents a place action link and its attributes.
      "createTime": "A String", # Output only. The time when the place action link was created.
      "isEditable": True or False, # Output only. Indicates whether this link can be edited by the client.
      "isPreferred": True or False, # 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.
      "name": "A String", # 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": "A String", # Required. The type of place action that can be performed using this link.
      "providerType": "A String", # Output only. Specifies the provider type.
      "updateTime": "A String", # Output only. The time when the place action link was last modified.
      "uri": "A 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).
    }

`delete(name, x__xgafv=None)`

    Deletes a place action link from the specified location.

    Args:
      name: string, Required. The resource name of the place action link to remove from the location. (required)
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.
    }

`get(name, x__xgafv=None)`

    Gets the specified place action link.

    Args:
      name: string, Required. The name of the place action link to fetch. (required)
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # Represents a place action link and its attributes.
      "createTime": "A String", # Output only. The time when the place action link was created.
      "isEditable": True or False, # Output only. Indicates whether this link can be edited by the client.
      "isPreferred": True or False, # 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.
      "name": "A String", # 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": "A String", # Required. The type of place action that can be performed using this link.
      "providerType": "A String", # Output only. Specifies the provider type.
      "updateTime": "A String", # Output only. The time when the place action link was last modified.
      "uri": "A 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).
    }

`list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)`

    Lists the place action links for the specified location.

    Args:
      parent: string, Required. The name of the location whose place action links will be listed. `locations/{location_id}`. (required)
      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. place_action_type=XYZ where XYZ is a valid PlaceActionType.
      pageSize: integer, Optional. How many place action links to return per page. Default of 10. The minimum is 1.
      pageToken: string, Optional. If specified, returns the next page of place action links.
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # Response message for PlaceActions.ListPlaceActionLinks.
      "nextPageToken": "A 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.
      "placeActionLinks": [ # The returned list of place action links.
        { # Represents a place action link and its attributes.
          "createTime": "A String", # Output only. The time when the place action link was created.
          "isEditable": True or False, # Output only. Indicates whether this link can be edited by the client.
          "isPreferred": True or False, # 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.
          "name": "A String", # 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": "A String", # Required. The type of place action that can be performed using this link.
          "providerType": "A String", # Output only. Specifies the provider type.
          "updateTime": "A String", # Output only. The time when the place action link was last modified.
          "uri": "A 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).
        },
      ],
    }

`list_next(previous_request, previous_response)`

    Retrieves the next page of results.

    Args:
      previous_request: The request for the previous page. (required)
      previous_response: The response from the request for the previous page. (required)

    Returns:
      A request object that you can call 'execute()' on to request the next
      page. Returns None if there are no more items in the collection.

`patch(name, body=None, updateMask=None, x__xgafv=None)`

    Updates the specified place action link and returns it.

    Args:
      name: string, 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. (required)
      body: object, The request body.
        The object takes the form of:

    { # Represents a place action link and its attributes.
      "createTime": "A String", # Output only. The time when the place action link was created.
      "isEditable": True or False, # Output only. Indicates whether this link can be edited by the client.
      "isPreferred": True or False, # 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.
      "name": "A String", # 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": "A String", # Required. The type of place action that can be performed using this link.
      "providerType": "A String", # Output only. Specifies the provider type.
      "updateTime": "A String", # Output only. The time when the place action link was last modified.
      "uri": "A 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).
    }

      updateMask: string, Required. The specific fields to update. The only editable fields are `uri`, `place_action_type` and `is_preferred`. If the updated link already exists at the same location with the same `place_action_type` and `uri`, fails with an `ALREADY_EXISTS` error.
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # Represents a place action link and its attributes.
      "createTime": "A String", # Output only. The time when the place action link was created.
      "isEditable": True or False, # Output only. Indicates whether this link can be edited by the client.
      "isPreferred": True or False, # 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.
      "name": "A String", # 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": "A String", # Required. The type of place action that can be performed using this link.
      "providerType": "A String", # Output only. Specifies the provider type.
      "updateTime": "A String", # Output only. The time when the place action link was last modified.
      "uri": "A 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).
    }