# Google Analytics API . management . accountUserLinks

## Instance Methods

Removes a user from the given account.

Adds a new user to the given account.

Lists account-user links for a given account.

Updates permissions for an existing user on the given account.

### Method Details

`delete(accountId, linkId)`

    Removes a user from the given account.

    Args:
      accountId: string, Account ID to delete the user link for. (required)
      linkId: string, Link ID to delete the user link for. (required)

`insert(accountId, body)`

    Adds a new user to the given account.

    Args:
      accountId: string, Account ID to create the user link for. (required)
      body: object, The request body. (required)
        The object takes the form of:

    { # JSON template for an Analytics Entity-User Link. Returns permissions that a user has for an entity.
        "kind": "analytics#entityUserLink", # Resource type for entity user link.
        "entity": { # Entity for this link. It can be an account, a web property, or a view (profile).
          "accountRef": { # JSON template for a linked account. # Account for this link.
            "kind": "analytics#accountRef", # Analytics account reference.
            "href": "A String", # Link for this account.
            "id": "A String", # Account ID.
            "name": "A String", # Account name.
          },
          "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.
          },
          "webPropertyRef": { # JSON template for a web property reference. # Web property for this link.
            "kind": "analytics#webPropertyRef", # Analytics web property reference.
            "name": "A String", # Name of this web property.
            "internalWebPropertyId": "A String", # Internal ID for this web property.
            "href": "A String", # Link for this web property.
            "id": "A String", # Web property ID of the form UA-XXXXX-YY.
            "accountId": "A String", # Account ID to which this web property belongs.
          },
        },
        "userRef": { # JSON template for a user reference. # User reference.
          "kind": "analytics#userRef",
          "email": "A String", # Email ID of this user.
          "id": "A String", # User ID.
        },
        "id": "A String", # Entity user link ID
        "selfLink": "A String", # Self link for this resource.
        "permissions": { # Permissions the user has for this entity.
          "local": [ # Permissions that a user has been assigned at this very level. Does not include any implied or inherited permissions. Local permissions are modifiable.
            "A String",
          ],
          "effective": [ # Effective permissions represent all the permissions that a user has for this entity. These include any implied permissions (e.g., EDIT implies VIEW) or inherited permissions from the parent entity. Effective permissions are read-only.
            "A String",
          ],
        },
      }

    Returns:
      An object of the form:

        { # JSON template for an Analytics Entity-User Link. Returns permissions that a user has for an entity.
          "kind": "analytics#entityUserLink", # Resource type for entity user link.
          "entity": { # Entity for this link. It can be an account, a web property, or a view (profile).
            "accountRef": { # JSON template for a linked account. # Account for this link.
              "kind": "analytics#accountRef", # Analytics account reference.
              "href": "A String", # Link for this account.
              "id": "A String", # Account ID.
              "name": "A String", # Account name.
            },
            "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.
            },
            "webPropertyRef": { # JSON template for a web property reference. # Web property for this link.
              "kind": "analytics#webPropertyRef", # Analytics web property reference.
              "name": "A String", # Name of this web property.
              "internalWebPropertyId": "A String", # Internal ID for this web property.
              "href": "A String", # Link for this web property.
              "id": "A String", # Web property ID of the form UA-XXXXX-YY.
              "accountId": "A String", # Account ID to which this web property belongs.
            },
          },
          "userRef": { # JSON template for a user reference. # User reference.
            "kind": "analytics#userRef",
            "email": "A String", # Email ID of this user.
            "id": "A String", # User ID.
          },
          "id": "A String", # Entity user link ID
          "selfLink": "A String", # Self link for this resource.
          "permissions": { # Permissions the user has for this entity.
            "local": [ # Permissions that a user has been assigned at this very level. Does not include any implied or inherited permissions. Local permissions are modifiable.
              "A String",
            ],
            "effective": [ # Effective permissions represent all the permissions that a user has for this entity. These include any implied permissions (e.g., EDIT implies VIEW) or inherited permissions from the parent entity. Effective permissions are read-only.
              "A String",
            ],
          },
        }

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

    Lists account-user links for a given account.

    Args:
      accountId: string, Account ID to retrieve the user links for. (required)
      max_results: integer, The maximum number of account-user links to include in this response.
      start_index: integer, An index of the first account-user link to retrieve. Use this parameter as a pagination mechanism along with the max-results parameter.

    Returns:
      An object of the form:

        { # An entity user link collection provides a list of Analytics ACL links Each resource in this collection corresponds to a single link.
        "kind": "analytics#entityUserLinks", # Collection type.
        "items": [ # A list of entity user links.
          { # JSON template for an Analytics Entity-User Link. Returns permissions that a user has for an entity.
              "kind": "analytics#entityUserLink", # Resource type for entity user link.
              "entity": { # Entity for this link. It can be an account, a web property, or a view (profile).
                "accountRef": { # JSON template for a linked account. # Account for this link.
                  "kind": "analytics#accountRef", # Analytics account reference.
                  "href": "A String", # Link for this account.
                  "id": "A String", # Account ID.
                  "name": "A String", # Account name.
                },
                "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.
                },
                "webPropertyRef": { # JSON template for a web property reference. # Web property for this link.
                  "kind": "analytics#webPropertyRef", # Analytics web property reference.
                  "name": "A String", # Name of this web property.
                  "internalWebPropertyId": "A String", # Internal ID for this web property.
                  "href": "A String", # Link for this web property.
                  "id": "A String", # Web property ID of the form UA-XXXXX-YY.
                  "accountId": "A String", # Account ID to which this web property belongs.
                },
              },
              "userRef": { # JSON template for a user reference. # User reference.
                "kind": "analytics#userRef",
                "email": "A String", # Email ID of this user.
                "id": "A String", # User ID.
              },
              "id": "A String", # Entity user link ID
              "selfLink": "A String", # Self link for this resource.
              "permissions": { # Permissions the user has for this entity.
                "local": [ # Permissions that a user has been assigned at this very level. Does not include any implied or inherited permissions. Local permissions are modifiable.
                  "A String",
                ],
                "effective": [ # Effective permissions represent all the permissions that a user has for this entity. These include any implied permissions (e.g., EDIT implies VIEW) or inherited permissions from the parent entity. Effective permissions are read-only.
                  "A String",
                ],
              },
            },
        ],
        "itemsPerPage": 42, # The maximum number of entries the response can contain, regardless of the actual number of entries returned. Its value ranges from 1 to 1000 with a value of 1000 by default, or otherwise specified by the max-results query parameter.
        "previousLink": "A String", # Previous link for this account collection.
        "startIndex": 42, # The starting index of the entries, which is 1 by default or otherwise specified by the start-index query parameter.
        "nextLink": "A String", # Next link for this account collection.
        "totalResults": 42, # The total number of results for the query, regardless of the number of results in the response.
      }

`update(accountId, linkId, body)`

    Updates permissions for an existing user on the given account.

    Args:
      accountId: string, Account ID to update the account-user link for. (required)
      linkId: string, Link ID to update the account-user link for. (required)
      body: object, The request body. (required)
        The object takes the form of:

    { # JSON template for an Analytics Entity-User Link. Returns permissions that a user has for an entity.
        "kind": "analytics#entityUserLink", # Resource type for entity user link.
        "entity": { # Entity for this link. It can be an account, a web property, or a view (profile).
          "accountRef": { # JSON template for a linked account. # Account for this link.
            "kind": "analytics#accountRef", # Analytics account reference.
            "href": "A String", # Link for this account.
            "id": "A String", # Account ID.
            "name": "A String", # Account name.
          },
          "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.
          },
          "webPropertyRef": { # JSON template for a web property reference. # Web property for this link.
            "kind": "analytics#webPropertyRef", # Analytics web property reference.
            "name": "A String", # Name of this web property.
            "internalWebPropertyId": "A String", # Internal ID for this web property.
            "href": "A String", # Link for this web property.
            "id": "A String", # Web property ID of the form UA-XXXXX-YY.
            "accountId": "A String", # Account ID to which this web property belongs.
          },
        },
        "userRef": { # JSON template for a user reference. # User reference.
          "kind": "analytics#userRef",
          "email": "A String", # Email ID of this user.
          "id": "A String", # User ID.
        },
        "id": "A String", # Entity user link ID
        "selfLink": "A String", # Self link for this resource.
        "permissions": { # Permissions the user has for this entity.
          "local": [ # Permissions that a user has been assigned at this very level. Does not include any implied or inherited permissions. Local permissions are modifiable.
            "A String",
          ],
          "effective": [ # Effective permissions represent all the permissions that a user has for this entity. These include any implied permissions (e.g., EDIT implies VIEW) or inherited permissions from the parent entity. Effective permissions are read-only.
            "A String",
          ],
        },
      }

    Returns:
      An object of the form:

        { # JSON template for an Analytics Entity-User Link. Returns permissions that a user has for an entity.
          "kind": "analytics#entityUserLink", # Resource type for entity user link.
          "entity": { # Entity for this link. It can be an account, a web property, or a view (profile).
            "accountRef": { # JSON template for a linked account. # Account for this link.
              "kind": "analytics#accountRef", # Analytics account reference.
              "href": "A String", # Link for this account.
              "id": "A String", # Account ID.
              "name": "A String", # Account name.
            },
            "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.
            },
            "webPropertyRef": { # JSON template for a web property reference. # Web property for this link.
              "kind": "analytics#webPropertyRef", # Analytics web property reference.
              "name": "A String", # Name of this web property.
              "internalWebPropertyId": "A String", # Internal ID for this web property.
              "href": "A String", # Link for this web property.
              "id": "A String", # Web property ID of the form UA-XXXXX-YY.
              "accountId": "A String", # Account ID to which this web property belongs.
            },
          },
          "userRef": { # JSON template for a user reference. # User reference.
            "kind": "analytics#userRef",
            "email": "A String", # Email ID of this user.
            "id": "A String", # User ID.
          },
          "id": "A String", # Entity user link ID
          "selfLink": "A String", # Self link for this resource.
          "permissions": { # Permissions the user has for this entity.
            "local": [ # Permissions that a user has been assigned at this very level. Does not include any implied or inherited permissions. Local permissions are modifiable.
              "A String",
            ],
            "effective": [ # Effective permissions represent all the permissions that a user has for this entity. These include any implied permissions (e.g., EDIT implies VIEW) or inherited permissions from the parent entity. Effective permissions are read-only.
              "A String",
            ],
          },
        }