# Google Analytics API . management . accountUserLinks

## Instance Methods

Close httplib2 connections.

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

`close()`

    Close httplib2 connections.

`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=None)`

    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.
        The object takes the form of:

    { # JSON template for an Analytics Entity-User Link. Returns permissions that a user has for an entity.
      "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.
          "href": "A String", # Link for this account.
          "id": "A String", # Account ID.
          "kind": "analytics#accountRef", # Analytics account reference.
          "name": "A String", # Account name.
        },
        "profileRef": { # JSON template for a linked view (profile). # View (Profile) for this link.
          "accountId": "A String", # Account ID to which this view (profile) belongs.
          "href": "A String", # Link for this view (profile).
          "id": "A String", # View (Profile) ID.
          "internalWebPropertyId": "A String", # Internal ID for the web property to which this view (profile) belongs.
          "kind": "analytics#profileRef", # Analytics view (profile) reference.
          "name": "A String", # Name of this view (profile).
          "webPropertyId": "A String", # Web property ID of the form UA-XXXXX-YY to which this view (profile) belongs.
        },
        "webPropertyRef": { # JSON template for a web property reference. # Web property for this link.
          "accountId": "A String", # Account ID to which this web property belongs.
          "href": "A String", # Link for this web property.
          "id": "A String", # Web property ID of the form UA-XXXXX-YY.
          "internalWebPropertyId": "A String", # Internal ID for this web property.
          "kind": "analytics#webPropertyRef", # Analytics web property reference.
          "name": "A String", # Name of this web property.
        },
      },
      "id": "A String", # Entity user link ID
      "kind": "analytics#entityUserLink", # Resource type for entity user link.
      "permissions": { # Permissions the user has for this entity.
        "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",
        ],
        "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",
        ],
      },
      "selfLink": "A String", # Self link for this resource.
      "userRef": { # JSON template for a user reference. # User reference.
        "email": "A String", # Email ID of this user.
        "id": "A String", # User ID.
        "kind": "analytics#userRef",
      },
    }

    Returns:
      An object of the form:

        { # JSON template for an Analytics Entity-User Link. Returns permissions that a user has for an entity.
      "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.
          "href": "A String", # Link for this account.
          "id": "A String", # Account ID.
          "kind": "analytics#accountRef", # Analytics account reference.
          "name": "A String", # Account name.
        },
        "profileRef": { # JSON template for a linked view (profile). # View (Profile) for this link.
          "accountId": "A String", # Account ID to which this view (profile) belongs.
          "href": "A String", # Link for this view (profile).
          "id": "A String", # View (Profile) ID.
          "internalWebPropertyId": "A String", # Internal ID for the web property to which this view (profile) belongs.
          "kind": "analytics#profileRef", # Analytics view (profile) reference.
          "name": "A String", # Name of this view (profile).
          "webPropertyId": "A String", # Web property ID of the form UA-XXXXX-YY to which this view (profile) belongs.
        },
        "webPropertyRef": { # JSON template for a web property reference. # Web property for this link.
          "accountId": "A String", # Account ID to which this web property belongs.
          "href": "A String", # Link for this web property.
          "id": "A String", # Web property ID of the form UA-XXXXX-YY.
          "internalWebPropertyId": "A String", # Internal ID for this web property.
          "kind": "analytics#webPropertyRef", # Analytics web property reference.
          "name": "A String", # Name of this web property.
        },
      },
      "id": "A String", # Entity user link ID
      "kind": "analytics#entityUserLink", # Resource type for entity user link.
      "permissions": { # Permissions the user has for this entity.
        "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",
        ],
        "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",
        ],
      },
      "selfLink": "A String", # Self link for this resource.
      "userRef": { # JSON template for a user reference. # User reference.
        "email": "A String", # Email ID of this user.
        "id": "A String", # User ID.
        "kind": "analytics#userRef",
      },
    }

`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.
      "items": [ # A list of entity user links.
        { # JSON template for an Analytics Entity-User Link. Returns permissions that a user has for an entity.
          "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.
              "href": "A String", # Link for this account.
              "id": "A String", # Account ID.
              "kind": "analytics#accountRef", # Analytics account reference.
              "name": "A String", # Account name.
            },
            "profileRef": { # JSON template for a linked view (profile). # View (Profile) for this link.
              "accountId": "A String", # Account ID to which this view (profile) belongs.
              "href": "A String", # Link for this view (profile).
              "id": "A String", # View (Profile) ID.
              "internalWebPropertyId": "A String", # Internal ID for the web property to which this view (profile) belongs.
              "kind": "analytics#profileRef", # Analytics view (profile) reference.
              "name": "A String", # Name of this view (profile).
              "webPropertyId": "A String", # Web property ID of the form UA-XXXXX-YY to which this view (profile) belongs.
            },
            "webPropertyRef": { # JSON template for a web property reference. # Web property for this link.
              "accountId": "A String", # Account ID to which this web property belongs.
              "href": "A String", # Link for this web property.
              "id": "A String", # Web property ID of the form UA-XXXXX-YY.
              "internalWebPropertyId": "A String", # Internal ID for this web property.
              "kind": "analytics#webPropertyRef", # Analytics web property reference.
              "name": "A String", # Name of this web property.
            },
          },
          "id": "A String", # Entity user link ID
          "kind": "analytics#entityUserLink", # Resource type for entity user link.
          "permissions": { # Permissions the user has for this entity.
            "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",
            ],
            "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",
            ],
          },
          "selfLink": "A String", # Self link for this resource.
          "userRef": { # JSON template for a user reference. # User reference.
            "email": "A String", # Email ID of this user.
            "id": "A String", # User ID.
            "kind": "analytics#userRef",
          },
        },
      ],
      "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.
      "kind": "analytics#entityUserLinks", # Collection type.
      "nextLink": "A String", # Next link for this account collection.
      "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.
      "totalResults": 42, # The total number of results for the query, regardless of the number of results in the response.
    }

`update(accountId, linkId, body=None)`

    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.
        The object takes the form of:

    { # JSON template for an Analytics Entity-User Link. Returns permissions that a user has for an entity.
      "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.
          "href": "A String", # Link for this account.
          "id": "A String", # Account ID.
          "kind": "analytics#accountRef", # Analytics account reference.
          "name": "A String", # Account name.
        },
        "profileRef": { # JSON template for a linked view (profile). # View (Profile) for this link.
          "accountId": "A String", # Account ID to which this view (profile) belongs.
          "href": "A String", # Link for this view (profile).
          "id": "A String", # View (Profile) ID.
          "internalWebPropertyId": "A String", # Internal ID for the web property to which this view (profile) belongs.
          "kind": "analytics#profileRef", # Analytics view (profile) reference.
          "name": "A String", # Name of this view (profile).
          "webPropertyId": "A String", # Web property ID of the form UA-XXXXX-YY to which this view (profile) belongs.
        },
        "webPropertyRef": { # JSON template for a web property reference. # Web property for this link.
          "accountId": "A String", # Account ID to which this web property belongs.
          "href": "A String", # Link for this web property.
          "id": "A String", # Web property ID of the form UA-XXXXX-YY.
          "internalWebPropertyId": "A String", # Internal ID for this web property.
          "kind": "analytics#webPropertyRef", # Analytics web property reference.
          "name": "A String", # Name of this web property.
        },
      },
      "id": "A String", # Entity user link ID
      "kind": "analytics#entityUserLink", # Resource type for entity user link.
      "permissions": { # Permissions the user has for this entity.
        "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",
        ],
        "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",
        ],
      },
      "selfLink": "A String", # Self link for this resource.
      "userRef": { # JSON template for a user reference. # User reference.
        "email": "A String", # Email ID of this user.
        "id": "A String", # User ID.
        "kind": "analytics#userRef",
      },
    }

    Returns:
      An object of the form:

        { # JSON template for an Analytics Entity-User Link. Returns permissions that a user has for an entity.
      "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.
          "href": "A String", # Link for this account.
          "id": "A String", # Account ID.
          "kind": "analytics#accountRef", # Analytics account reference.
          "name": "A String", # Account name.
        },
        "profileRef": { # JSON template for a linked view (profile). # View (Profile) for this link.
          "accountId": "A String", # Account ID to which this view (profile) belongs.
          "href": "A String", # Link for this view (profile).
          "id": "A String", # View (Profile) ID.
          "internalWebPropertyId": "A String", # Internal ID for the web property to which this view (profile) belongs.
          "kind": "analytics#profileRef", # Analytics view (profile) reference.
          "name": "A String", # Name of this view (profile).
          "webPropertyId": "A String", # Web property ID of the form UA-XXXXX-YY to which this view (profile) belongs.
        },
        "webPropertyRef": { # JSON template for a web property reference. # Web property for this link.
          "accountId": "A String", # Account ID to which this web property belongs.
          "href": "A String", # Link for this web property.
          "id": "A String", # Web property ID of the form UA-XXXXX-YY.
          "internalWebPropertyId": "A String", # Internal ID for this web property.
          "kind": "analytics#webPropertyRef", # Analytics web property reference.
          "name": "A String", # Name of this web property.
        },
      },
      "id": "A String", # Entity user link ID
      "kind": "analytics#entityUserLink", # Resource type for entity user link.
      "permissions": { # Permissions the user has for this entity.
        "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",
        ],
        "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",
        ],
      },
      "selfLink": "A String", # Self link for this resource.
      "userRef": { # JSON template for a user reference. # User reference.
        "email": "A String", # Email ID of this user.
        "id": "A String", # User ID.
        "kind": "analytics#userRef",
      },
    }