Google Analytics API . management . webpropertyUserLinks

Instance Methods

close()

Close httplib2 connections.

delete(accountId, webPropertyId, linkId)

Removes a user from the given web property.

insert(accountId, webPropertyId, body=None)

Adds a new user to the given web property.

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

Lists webProperty-user links for a given web property.

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

Updates permissions for an existing user on the given web property.

Method Details

close()
Close httplib2 connections.
delete(accountId, webPropertyId, linkId)
Removes a user from the given web property.

Args:
  accountId: string, Account ID to delete the user link for. (required)
  webPropertyId: string, Web Property ID to delete the user link for. (required)
  linkId: string, Link ID to delete the user link for. (required)
insert(accountId, webPropertyId, body=None)
Adds a new user to the given web property.

Args:
  accountId: string, Account ID to create the user link for. (required)
  webPropertyId: string, Web Property 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, webPropertyId, max_results=None, start_index=None)
Lists webProperty-user links for a given web property.

Args:
  accountId: string, Account ID which the given web property belongs to. (required)
  webPropertyId: string, Web Property ID for the webProperty-user links to retrieve. Can either be a specific web property ID or '~all', which refers to all the web properties that user has access to. (required)
  max_results: integer, The maximum number of webProperty-user Links to include in this response.
  start_index: integer, An index of the first webProperty-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, webPropertyId, linkId, body=None)
Updates permissions for an existing user on the given web property.

Args:
  accountId: string, Account ID to update the account-user link for. (required)
  webPropertyId: string, Web property 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",
  },
}