# Google Analytics API . management . profileFilterLinks

## Instance Methods

Delete a profile filter link.

Returns a single profile filter link.

Create a new profile filter link.

Lists all profile filter links for a profile.

Update an existing profile filter link. This method supports patch semantics.

Update an existing profile filter link.

### Method Details

`delete(accountId, webPropertyId, profileId, linkId)`

    Delete a profile filter link.

    Args:
      accountId: string, Account ID to which the profile filter link belongs. (required)
      webPropertyId: string, Web property Id to which the profile filter link belongs. (required)
      profileId: string, Profile ID to which the filter link belongs. (required)
      linkId: string, ID of the profile filter link to delete. (required)

`get(accountId, webPropertyId, profileId, linkId)`

    Returns a single profile filter link.

    Args:
      accountId: string, Account ID to retrieve profile filter link for. (required)
      webPropertyId: string, Web property Id to retrieve profile filter link for. (required)
      profileId: string, Profile ID to retrieve filter link for. (required)
      linkId: string, ID of the profile filter link. (required)

    Returns:
      An object of the form:

        { # JSON template for an Analytics profile filter link.
          "kind": "analytics#profileFilterLink", # Resource type for Analytics filter.
          "rank": 42, # The rank of this profile filter link relative to the other filters linked to the same profile.
              # For readonly (i.e., list and get) operations, the rank always starts at 1.
              # For write (i.e., create, update, or delete) operations, you may specify a value between 0 and 255 inclusively, [0, 255]. In order to insert a link at the end of the list, either don't specify a rank or set a rank to a number greater than the largest rank in the list. In order to insert a link to the beginning of the list specify a rank that is less than or equal to 1. The new link will move all existing filters with the same or lower rank down the list. After the link is inserted/updated/deleted all profile filter links will be renumbered starting at 1.
          "filterRef": { # JSON template for a profile filter link. # Filter for this link.
            "kind": "analytics#filterRef", # Kind value for filter reference.
            "href": "A String", # Link for this filter.
            "id": "A String", # Filter ID.
            "name": "A String", # Name of this filter.
            "accountId": "A String", # Account ID to which this filter belongs.
          },
          "profileRef": { # JSON template for a linked view (profile). # View (Profile) for this link.
            "kind": "analytics#profileRef", # Analytics view (profile) reference.
            "name": "A String", # Name of this view (profile).
            "internalWebPropertyId": "A String", # Internal ID for the web property to which this view (profile) belongs.
            "href": "A String", # Link for this view (profile).
            "webPropertyId": "A String", # Web property ID of the form UA-XXXXX-YY to which this view (profile) belongs.
            "id": "A String", # View (Profile) ID.
            "accountId": "A String", # Account ID to which this view (profile) belongs.
          },
          "id": "A String", # Profile filter link ID.
          "selfLink": "A String", # Link for this profile filter link.
        }

`insert(accountId, webPropertyId, profileId, body)`

    Create a new profile filter link.

    Args:
      accountId: string, Account ID to create profile filter link for. (required)
      webPropertyId: string, Web property Id to create profile filter link for. (required)
      profileId: string, Profile ID to create filter link for. (required)
      body: object, The request body. (required)
        The object takes the form of:

    { # JSON template for an Analytics profile filter link.
        "kind": "analytics#profileFilterLink", # Resource type for Analytics filter.
        "rank": 42, # The rank of this profile filter link relative to the other filters linked to the same profile.
            # For readonly (i.e., list and get) operations, the rank always starts at 1.
            # For write (i.e., create, update, or delete) operations, you may specify a value between 0 and 255 inclusively, [0, 255]. In order to insert a link at the end of the list, either don't specify a rank or set a rank to a number greater than the largest rank in the list. In order to insert a link to the beginning of the list specify a rank that is less than or equal to 1. The new link will move all existing filters with the same or lower rank down the list. After the link is inserted/updated/deleted all profile filter links will be renumbered starting at 1.
        "filterRef": { # JSON template for a profile filter link. # Filter for this link.
          "kind": "analytics#filterRef", # Kind value for filter reference.
          "href": "A String", # Link for this filter.
          "id": "A String", # Filter ID.
          "name": "A String", # Name of this filter.
          "accountId": "A String", # Account ID to which this filter belongs.
        },
        "profileRef": { # JSON template for a linked view (profile). # View (Profile) for this link.
          "kind": "analytics#profileRef", # Analytics view (profile) reference.
          "name": "A String", # Name of this view (profile).
          "internalWebPropertyId": "A String", # Internal ID for the web property to which this view (profile) belongs.
          "href": "A String", # Link for this view (profile).
          "webPropertyId": "A String", # Web property ID of the form UA-XXXXX-YY to which this view (profile) belongs.
          "id": "A String", # View (Profile) ID.
          "accountId": "A String", # Account ID to which this view (profile) belongs.
        },
        "id": "A String", # Profile filter link ID.
        "selfLink": "A String", # Link for this profile filter link.
      }

    Returns:
      An object of the form:

        { # JSON template for an Analytics profile filter link.
          "kind": "analytics#profileFilterLink", # Resource type for Analytics filter.
          "rank": 42, # The rank of this profile filter link relative to the other filters linked to the same profile.
              # For readonly (i.e., list and get) operations, the rank always starts at 1.
              # For write (i.e., create, update, or delete) operations, you may specify a value between 0 and 255 inclusively, [0, 255]. In order to insert a link at the end of the list, either don't specify a rank or set a rank to a number greater than the largest rank in the list. In order to insert a link to the beginning of the list specify a rank that is less than or equal to 1. The new link will move all existing filters with the same or lower rank down the list. After the link is inserted/updated/deleted all profile filter links will be renumbered starting at 1.
          "filterRef": { # JSON template for a profile filter link. # Filter for this link.
            "kind": "analytics#filterRef", # Kind value for filter reference.
            "href": "A String", # Link for this filter.
            "id": "A String", # Filter ID.
            "name": "A String", # Name of this filter.
            "accountId": "A String", # Account ID to which this filter belongs.
          },
          "profileRef": { # JSON template for a linked view (profile). # View (Profile) for this link.
            "kind": "analytics#profileRef", # Analytics view (profile) reference.
            "name": "A String", # Name of this view (profile).
            "internalWebPropertyId": "A String", # Internal ID for the web property to which this view (profile) belongs.
            "href": "A String", # Link for this view (profile).
            "webPropertyId": "A String", # Web property ID of the form UA-XXXXX-YY to which this view (profile) belongs.
            "id": "A String", # View (Profile) ID.
            "accountId": "A String", # Account ID to which this view (profile) belongs.
          },
          "id": "A String", # Profile filter link ID.
          "selfLink": "A String", # Link for this profile filter link.
        }

`list(accountId, webPropertyId, profileId, max_results=None, start_index=None)`

    Lists all profile filter links for a profile.

    Args:
      accountId: string, Account ID to retrieve profile filter links for. (required)
      webPropertyId: string, Web property Id for profile filter links for. Can either be a specific web property ID or '~all', which refers to all the web properties that user has access to. (required)
      profileId: string, Profile ID to retrieve filter links for. Can either be a specific profile ID or '~all', which refers to all the profiles that user has access to. (required)
      max_results: integer, The maximum number of profile filter links to include in this response.
      start_index: integer, An index of the first entity to retrieve. Use this parameter as a pagination mechanism along with the max-results parameter.

    Returns:
      An object of the form:

        { # A profile filter link collection lists profile filter links between profiles and filters. Each resource in the collection corresponds to a profile filter link.
        "username": "A String", # Email ID of the authenticated user
        "kind": "analytics#profileFilterLinks", # Collection type.
        "items": [ # A list of profile filter links.
          { # JSON template for an Analytics profile filter link.
              "kind": "analytics#profileFilterLink", # Resource type for Analytics filter.
              "rank": 42, # The rank of this profile filter link relative to the other filters linked to the same profile.
                  # For readonly (i.e., list and get) operations, the rank always starts at 1.
                  # For write (i.e., create, update, or delete) operations, you may specify a value between 0 and 255 inclusively, [0, 255]. In order to insert a link at the end of the list, either don't specify a rank or set a rank to a number greater than the largest rank in the list. In order to insert a link to the beginning of the list specify a rank that is less than or equal to 1. The new link will move all existing filters with the same or lower rank down the list. After the link is inserted/updated/deleted all profile filter links will be renumbered starting at 1.
              "filterRef": { # JSON template for a profile filter link. # Filter for this link.
                "kind": "analytics#filterRef", # Kind value for filter reference.
                "href": "A String", # Link for this filter.
                "id": "A String", # Filter ID.
                "name": "A String", # Name of this filter.
                "accountId": "A String", # Account ID to which this filter belongs.
              },
              "profileRef": { # JSON template for a linked view (profile). # View (Profile) for this link.
                "kind": "analytics#profileRef", # Analytics view (profile) reference.
                "name": "A String", # Name of this view (profile).
                "internalWebPropertyId": "A String", # Internal ID for the web property to which this view (profile) belongs.
                "href": "A String", # Link for this view (profile).
                "webPropertyId": "A String", # Web property ID of the form UA-XXXXX-YY to which this view (profile) belongs.
                "id": "A String", # View (Profile) ID.
                "accountId": "A String", # Account ID to which this view (profile) belongs.
              },
              "id": "A String", # Profile filter link ID.
              "selfLink": "A String", # Link for this profile filter link.
            },
        ],
        "itemsPerPage": 42, # The maximum number of resources the response can contain, regardless of the actual number of resources returned. Its value ranges from 1 to 1,000 with a value of 1000 by default, or otherwise specified by the max-results query parameter.
        "previousLink": "A String", # Link to previous page for this profile filter link collection.
        "startIndex": 42, # The starting index of the resources, which is 1 by default or otherwise specified by the start-index query parameter.
        "nextLink": "A String", # Link to next page for this profile filter link collection.
        "totalResults": 42, # The total number of results for the query, regardless of the number of results in the response.
      }

`patch(accountId, webPropertyId, profileId, linkId, body)`

    Update an existing profile filter link. This method supports patch semantics.

    Args:
      accountId: string, Account ID to which profile filter link belongs. (required)
      webPropertyId: string, Web property Id to which profile filter link belongs (required)
      profileId: string, Profile ID to which filter link belongs (required)
      linkId: string, ID of the profile filter link to be updated. (required)
      body: object, The request body. (required)
        The object takes the form of:

    { # JSON template for an Analytics profile filter link.
        "kind": "analytics#profileFilterLink", # Resource type for Analytics filter.
        "rank": 42, # The rank of this profile filter link relative to the other filters linked to the same profile.
            # For readonly (i.e., list and get) operations, the rank always starts at 1.
            # For write (i.e., create, update, or delete) operations, you may specify a value between 0 and 255 inclusively, [0, 255]. In order to insert a link at the end of the list, either don't specify a rank or set a rank to a number greater than the largest rank in the list. In order to insert a link to the beginning of the list specify a rank that is less than or equal to 1. The new link will move all existing filters with the same or lower rank down the list. After the link is inserted/updated/deleted all profile filter links will be renumbered starting at 1.
        "filterRef": { # JSON template for a profile filter link. # Filter for this link.
          "kind": "analytics#filterRef", # Kind value for filter reference.
          "href": "A String", # Link for this filter.
          "id": "A String", # Filter ID.
          "name": "A String", # Name of this filter.
          "accountId": "A String", # Account ID to which this filter belongs.
        },
        "profileRef": { # JSON template for a linked view (profile). # View (Profile) for this link.
          "kind": "analytics#profileRef", # Analytics view (profile) reference.
          "name": "A String", # Name of this view (profile).
          "internalWebPropertyId": "A String", # Internal ID for the web property to which this view (profile) belongs.
          "href": "A String", # Link for this view (profile).
          "webPropertyId": "A String", # Web property ID of the form UA-XXXXX-YY to which this view (profile) belongs.
          "id": "A String", # View (Profile) ID.
          "accountId": "A String", # Account ID to which this view (profile) belongs.
        },
        "id": "A String", # Profile filter link ID.
        "selfLink": "A String", # Link for this profile filter link.
      }

    Returns:
      An object of the form:

        { # JSON template for an Analytics profile filter link.
          "kind": "analytics#profileFilterLink", # Resource type for Analytics filter.
          "rank": 42, # The rank of this profile filter link relative to the other filters linked to the same profile.
              # For readonly (i.e., list and get) operations, the rank always starts at 1.
              # For write (i.e., create, update, or delete) operations, you may specify a value between 0 and 255 inclusively, [0, 255]. In order to insert a link at the end of the list, either don't specify a rank or set a rank to a number greater than the largest rank in the list. In order to insert a link to the beginning of the list specify a rank that is less than or equal to 1. The new link will move all existing filters with the same or lower rank down the list. After the link is inserted/updated/deleted all profile filter links will be renumbered starting at 1.
          "filterRef": { # JSON template for a profile filter link. # Filter for this link.
            "kind": "analytics#filterRef", # Kind value for filter reference.
            "href": "A String", # Link for this filter.
            "id": "A String", # Filter ID.
            "name": "A String", # Name of this filter.
            "accountId": "A String", # Account ID to which this filter belongs.
          },
          "profileRef": { # JSON template for a linked view (profile). # View (Profile) for this link.
            "kind": "analytics#profileRef", # Analytics view (profile) reference.
            "name": "A String", # Name of this view (profile).
            "internalWebPropertyId": "A String", # Internal ID for the web property to which this view (profile) belongs.
            "href": "A String", # Link for this view (profile).
            "webPropertyId": "A String", # Web property ID of the form UA-XXXXX-YY to which this view (profile) belongs.
            "id": "A String", # View (Profile) ID.
            "accountId": "A String", # Account ID to which this view (profile) belongs.
          },
          "id": "A String", # Profile filter link ID.
          "selfLink": "A String", # Link for this profile filter link.
        }

`update(accountId, webPropertyId, profileId, linkId, body)`

    Update an existing profile filter link.

    Args:
      accountId: string, Account ID to which profile filter link belongs. (required)
      webPropertyId: string, Web property Id to which profile filter link belongs (required)
      profileId: string, Profile ID to which filter link belongs (required)
      linkId: string, ID of the profile filter link to be updated. (required)
      body: object, The request body. (required)
        The object takes the form of:

    { # JSON template for an Analytics profile filter link.
        "kind": "analytics#profileFilterLink", # Resource type for Analytics filter.
        "rank": 42, # The rank of this profile filter link relative to the other filters linked to the same profile.
            # For readonly (i.e., list and get) operations, the rank always starts at 1.
            # For write (i.e., create, update, or delete) operations, you may specify a value between 0 and 255 inclusively, [0, 255]. In order to insert a link at the end of the list, either don't specify a rank or set a rank to a number greater than the largest rank in the list. In order to insert a link to the beginning of the list specify a rank that is less than or equal to 1. The new link will move all existing filters with the same or lower rank down the list. After the link is inserted/updated/deleted all profile filter links will be renumbered starting at 1.
        "filterRef": { # JSON template for a profile filter link. # Filter for this link.
          "kind": "analytics#filterRef", # Kind value for filter reference.
          "href": "A String", # Link for this filter.
          "id": "A String", # Filter ID.
          "name": "A String", # Name of this filter.
          "accountId": "A String", # Account ID to which this filter belongs.
        },
        "profileRef": { # JSON template for a linked view (profile). # View (Profile) for this link.
          "kind": "analytics#profileRef", # Analytics view (profile) reference.
          "name": "A String", # Name of this view (profile).
          "internalWebPropertyId": "A String", # Internal ID for the web property to which this view (profile) belongs.
          "href": "A String", # Link for this view (profile).
          "webPropertyId": "A String", # Web property ID of the form UA-XXXXX-YY to which this view (profile) belongs.
          "id": "A String", # View (Profile) ID.
          "accountId": "A String", # Account ID to which this view (profile) belongs.
        },
        "id": "A String", # Profile filter link ID.
        "selfLink": "A String", # Link for this profile filter link.
      }

    Returns:
      An object of the form:

        { # JSON template for an Analytics profile filter link.
          "kind": "analytics#profileFilterLink", # Resource type for Analytics filter.
          "rank": 42, # The rank of this profile filter link relative to the other filters linked to the same profile.
              # For readonly (i.e., list and get) operations, the rank always starts at 1.
              # For write (i.e., create, update, or delete) operations, you may specify a value between 0 and 255 inclusively, [0, 255]. In order to insert a link at the end of the list, either don't specify a rank or set a rank to a number greater than the largest rank in the list. In order to insert a link to the beginning of the list specify a rank that is less than or equal to 1. The new link will move all existing filters with the same or lower rank down the list. After the link is inserted/updated/deleted all profile filter links will be renumbered starting at 1.
          "filterRef": { # JSON template for a profile filter link. # Filter for this link.
            "kind": "analytics#filterRef", # Kind value for filter reference.
            "href": "A String", # Link for this filter.
            "id": "A String", # Filter ID.
            "name": "A String", # Name of this filter.
            "accountId": "A String", # Account ID to which this filter belongs.
          },
          "profileRef": { # JSON template for a linked view (profile). # View (Profile) for this link.
            "kind": "analytics#profileRef", # Analytics view (profile) reference.
            "name": "A String", # Name of this view (profile).
            "internalWebPropertyId": "A String", # Internal ID for the web property to which this view (profile) belongs.
            "href": "A String", # Link for this view (profile).
            "webPropertyId": "A String", # Web property ID of the form UA-XXXXX-YY to which this view (profile) belongs.
            "id": "A String", # View (Profile) ID.
            "accountId": "A String", # Account ID to which this view (profile) belongs.
          },
          "id": "A String", # Profile filter link ID.
          "selfLink": "A String", # Link for this profile filter link.
        }