Home | History | Annotate | Download | only in dyn
      1 <html><body>
      2 <style>
      3 
      4 body, h1, h2, h3, div, span, p, pre, a {
      5   margin: 0;
      6   padding: 0;
      7   border: 0;
      8   font-weight: inherit;
      9   font-style: inherit;
     10   font-size: 100%;
     11   font-family: inherit;
     12   vertical-align: baseline;
     13 }
     14 
     15 body {
     16   font-size: 13px;
     17   padding: 1em;
     18 }
     19 
     20 h1 {
     21   font-size: 26px;
     22   margin-bottom: 1em;
     23 }
     24 
     25 h2 {
     26   font-size: 24px;
     27   margin-bottom: 1em;
     28 }
     29 
     30 h3 {
     31   font-size: 20px;
     32   margin-bottom: 1em;
     33   margin-top: 1em;
     34 }
     35 
     36 pre, code {
     37   line-height: 1.5;
     38   font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
     39 }
     40 
     41 pre {
     42   margin-top: 0.5em;
     43 }
     44 
     45 h1, h2, h3, p {
     46   font-family: Arial, sans serif;
     47 }
     48 
     49 h1, h2, h3 {
     50   border-bottom: solid #CCC 1px;
     51 }
     52 
     53 .toc_element {
     54   margin-top: 0.5em;
     55 }
     56 
     57 .firstline {
     58   margin-left: 2 em;
     59 }
     60 
     61 .method  {
     62   margin-top: 1em;
     63   border: solid 1px #CCC;
     64   padding: 1em;
     65   background: #EEE;
     66 }
     67 
     68 .details {
     69   font-weight: bold;
     70   font-size: 14px;
     71 }
     72 
     73 </style>
     74 
     75 <h1><a href="analytics_v3.html">Google Analytics API</a> . <a href="analytics_v3.management.html">management</a> . <a href="analytics_v3.management.accountUserLinks.html">accountUserLinks</a></h1>
     76 <h2>Instance Methods</h2>
     77 <p class="toc_element">
     78   <code><a href="#delete">delete(accountId, linkId)</a></code></p>
     79 <p class="firstline">Removes a user from the given account.</p>
     80 <p class="toc_element">
     81   <code><a href="#insert">insert(accountId, body)</a></code></p>
     82 <p class="firstline">Adds a new user to the given account.</p>
     83 <p class="toc_element">
     84   <code><a href="#list">list(accountId, max_results=None, start_index=None)</a></code></p>
     85 <p class="firstline">Lists account-user links for a given account.</p>
     86 <p class="toc_element">
     87   <code><a href="#update">update(accountId, linkId, body)</a></code></p>
     88 <p class="firstline">Updates permissions for an existing user on the given account.</p>
     89 <h3>Method Details</h3>
     90 <div class="method">
     91     <code class="details" id="delete">delete(accountId, linkId)</code>
     92   <pre>Removes a user from the given account.
     93 
     94 Args:
     95   accountId: string, Account ID to delete the user link for. (required)
     96   linkId: string, Link ID to delete the user link for. (required)
     97 </pre>
     98 </div>
     99 
    100 <div class="method">
    101     <code class="details" id="insert">insert(accountId, body)</code>
    102   <pre>Adds a new user to the given account.
    103 
    104 Args:
    105   accountId: string, Account ID to create the user link for. (required)
    106   body: object, The request body. (required)
    107     The object takes the form of:
    108 
    109 { # JSON template for an Analytics Entity-User Link. Returns permissions that a user has for an entity.
    110     "kind": "analytics#entityUserLink", # Resource type for entity user link.
    111     "entity": { # Entity for this link. It can be an account, a web property, or a view (profile).
    112       "accountRef": { # JSON template for a linked account. # Account for this link.
    113         "kind": "analytics#accountRef", # Analytics account reference.
    114         "href": "A String", # Link for this account.
    115         "id": "A String", # Account ID.
    116         "name": "A String", # Account name.
    117       },
    118       "profileRef": { # JSON template for a linked view (profile). # View (Profile) for this link.
    119         "kind": "analytics#profileRef", # Analytics view (profile) reference.
    120         "name": "A String", # Name of this view (profile).
    121         "internalWebPropertyId": "A String", # Internal ID for the web property to which this view (profile) belongs.
    122         "href": "A String", # Link for this view (profile).
    123         "webPropertyId": "A String", # Web property ID of the form UA-XXXXX-YY to which this view (profile) belongs.
    124         "id": "A String", # View (Profile) ID.
    125         "accountId": "A String", # Account ID to which this view (profile) belongs.
    126       },
    127       "webPropertyRef": { # JSON template for a web property reference. # Web property for this link.
    128         "kind": "analytics#webPropertyRef", # Analytics web property reference.
    129         "name": "A String", # Name of this web property.
    130         "internalWebPropertyId": "A String", # Internal ID for this web property.
    131         "href": "A String", # Link for this web property.
    132         "id": "A String", # Web property ID of the form UA-XXXXX-YY.
    133         "accountId": "A String", # Account ID to which this web property belongs.
    134       },
    135     },
    136     "userRef": { # JSON template for a user reference. # User reference.
    137       "kind": "analytics#userRef",
    138       "email": "A String", # Email ID of this user.
    139       "id": "A String", # User ID.
    140     },
    141     "id": "A String", # Entity user link ID
    142     "selfLink": "A String", # Self link for this resource.
    143     "permissions": { # Permissions the user has for this entity.
    144       "local": [ # Permissions that a user has been assigned at this very level. Does not include any implied or inherited permissions. Local permissions are modifiable.
    145         "A String",
    146       ],
    147       "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.
    148         "A String",
    149       ],
    150     },
    151   }
    152 
    153 
    154 Returns:
    155   An object of the form:
    156 
    157     { # JSON template for an Analytics Entity-User Link. Returns permissions that a user has for an entity.
    158       "kind": "analytics#entityUserLink", # Resource type for entity user link.
    159       "entity": { # Entity for this link. It can be an account, a web property, or a view (profile).
    160         "accountRef": { # JSON template for a linked account. # Account for this link.
    161           "kind": "analytics#accountRef", # Analytics account reference.
    162           "href": "A String", # Link for this account.
    163           "id": "A String", # Account ID.
    164           "name": "A String", # Account name.
    165         },
    166         "profileRef": { # JSON template for a linked view (profile). # View (Profile) for this link.
    167           "kind": "analytics#profileRef", # Analytics view (profile) reference.
    168           "name": "A String", # Name of this view (profile).
    169           "internalWebPropertyId": "A String", # Internal ID for the web property to which this view (profile) belongs.
    170           "href": "A String", # Link for this view (profile).
    171           "webPropertyId": "A String", # Web property ID of the form UA-XXXXX-YY to which this view (profile) belongs.
    172           "id": "A String", # View (Profile) ID.
    173           "accountId": "A String", # Account ID to which this view (profile) belongs.
    174         },
    175         "webPropertyRef": { # JSON template for a web property reference. # Web property for this link.
    176           "kind": "analytics#webPropertyRef", # Analytics web property reference.
    177           "name": "A String", # Name of this web property.
    178           "internalWebPropertyId": "A String", # Internal ID for this web property.
    179           "href": "A String", # Link for this web property.
    180           "id": "A String", # Web property ID of the form UA-XXXXX-YY.
    181           "accountId": "A String", # Account ID to which this web property belongs.
    182         },
    183       },
    184       "userRef": { # JSON template for a user reference. # User reference.
    185         "kind": "analytics#userRef",
    186         "email": "A String", # Email ID of this user.
    187         "id": "A String", # User ID.
    188       },
    189       "id": "A String", # Entity user link ID
    190       "selfLink": "A String", # Self link for this resource.
    191       "permissions": { # Permissions the user has for this entity.
    192         "local": [ # Permissions that a user has been assigned at this very level. Does not include any implied or inherited permissions. Local permissions are modifiable.
    193           "A String",
    194         ],
    195         "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.
    196           "A String",
    197         ],
    198       },
    199     }</pre>
    200 </div>
    201 
    202 <div class="method">
    203     <code class="details" id="list">list(accountId, max_results=None, start_index=None)</code>
    204   <pre>Lists account-user links for a given account.
    205 
    206 Args:
    207   accountId: string, Account ID to retrieve the user links for. (required)
    208   max_results: integer, The maximum number of account-user links to include in this response.
    209   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.
    210 
    211 Returns:
    212   An object of the form:
    213 
    214     { # An entity user link collection provides a list of Analytics ACL links Each resource in this collection corresponds to a single link.
    215     "kind": "analytics#entityUserLinks", # Collection type.
    216     "items": [ # A list of entity user links.
    217       { # JSON template for an Analytics Entity-User Link. Returns permissions that a user has for an entity.
    218           "kind": "analytics#entityUserLink", # Resource type for entity user link.
    219           "entity": { # Entity for this link. It can be an account, a web property, or a view (profile).
    220             "accountRef": { # JSON template for a linked account. # Account for this link.
    221               "kind": "analytics#accountRef", # Analytics account reference.
    222               "href": "A String", # Link for this account.
    223               "id": "A String", # Account ID.
    224               "name": "A String", # Account name.
    225             },
    226             "profileRef": { # JSON template for a linked view (profile). # View (Profile) for this link.
    227               "kind": "analytics#profileRef", # Analytics view (profile) reference.
    228               "name": "A String", # Name of this view (profile).
    229               "internalWebPropertyId": "A String", # Internal ID for the web property to which this view (profile) belongs.
    230               "href": "A String", # Link for this view (profile).
    231               "webPropertyId": "A String", # Web property ID of the form UA-XXXXX-YY to which this view (profile) belongs.
    232               "id": "A String", # View (Profile) ID.
    233               "accountId": "A String", # Account ID to which this view (profile) belongs.
    234             },
    235             "webPropertyRef": { # JSON template for a web property reference. # Web property for this link.
    236               "kind": "analytics#webPropertyRef", # Analytics web property reference.
    237               "name": "A String", # Name of this web property.
    238               "internalWebPropertyId": "A String", # Internal ID for this web property.
    239               "href": "A String", # Link for this web property.
    240               "id": "A String", # Web property ID of the form UA-XXXXX-YY.
    241               "accountId": "A String", # Account ID to which this web property belongs.
    242             },
    243           },
    244           "userRef": { # JSON template for a user reference. # User reference.
    245             "kind": "analytics#userRef",
    246             "email": "A String", # Email ID of this user.
    247             "id": "A String", # User ID.
    248           },
    249           "id": "A String", # Entity user link ID
    250           "selfLink": "A String", # Self link for this resource.
    251           "permissions": { # Permissions the user has for this entity.
    252             "local": [ # Permissions that a user has been assigned at this very level. Does not include any implied or inherited permissions. Local permissions are modifiable.
    253               "A String",
    254             ],
    255             "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.
    256               "A String",
    257             ],
    258           },
    259         },
    260     ],
    261     "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.
    262     "previousLink": "A String", # Previous link for this account collection.
    263     "startIndex": 42, # The starting index of the entries, which is 1 by default or otherwise specified by the start-index query parameter.
    264     "nextLink": "A String", # Next link for this account collection.
    265     "totalResults": 42, # The total number of results for the query, regardless of the number of results in the response.
    266   }</pre>
    267 </div>
    268 
    269 <div class="method">
    270     <code class="details" id="update">update(accountId, linkId, body)</code>
    271   <pre>Updates permissions for an existing user on the given account.
    272 
    273 Args:
    274   accountId: string, Account ID to update the account-user link for. (required)
    275   linkId: string, Link ID to update the account-user link for. (required)
    276   body: object, The request body. (required)
    277     The object takes the form of:
    278 
    279 { # JSON template for an Analytics Entity-User Link. Returns permissions that a user has for an entity.
    280     "kind": "analytics#entityUserLink", # Resource type for entity user link.
    281     "entity": { # Entity for this link. It can be an account, a web property, or a view (profile).
    282       "accountRef": { # JSON template for a linked account. # Account for this link.
    283         "kind": "analytics#accountRef", # Analytics account reference.
    284         "href": "A String", # Link for this account.
    285         "id": "A String", # Account ID.
    286         "name": "A String", # Account name.
    287       },
    288       "profileRef": { # JSON template for a linked view (profile). # View (Profile) for this link.
    289         "kind": "analytics#profileRef", # Analytics view (profile) reference.
    290         "name": "A String", # Name of this view (profile).
    291         "internalWebPropertyId": "A String", # Internal ID for the web property to which this view (profile) belongs.
    292         "href": "A String", # Link for this view (profile).
    293         "webPropertyId": "A String", # Web property ID of the form UA-XXXXX-YY to which this view (profile) belongs.
    294         "id": "A String", # View (Profile) ID.
    295         "accountId": "A String", # Account ID to which this view (profile) belongs.
    296       },
    297       "webPropertyRef": { # JSON template for a web property reference. # Web property for this link.
    298         "kind": "analytics#webPropertyRef", # Analytics web property reference.
    299         "name": "A String", # Name of this web property.
    300         "internalWebPropertyId": "A String", # Internal ID for this web property.
    301         "href": "A String", # Link for this web property.
    302         "id": "A String", # Web property ID of the form UA-XXXXX-YY.
    303         "accountId": "A String", # Account ID to which this web property belongs.
    304       },
    305     },
    306     "userRef": { # JSON template for a user reference. # User reference.
    307       "kind": "analytics#userRef",
    308       "email": "A String", # Email ID of this user.
    309       "id": "A String", # User ID.
    310     },
    311     "id": "A String", # Entity user link ID
    312     "selfLink": "A String", # Self link for this resource.
    313     "permissions": { # Permissions the user has for this entity.
    314       "local": [ # Permissions that a user has been assigned at this very level. Does not include any implied or inherited permissions. Local permissions are modifiable.
    315         "A String",
    316       ],
    317       "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.
    318         "A String",
    319       ],
    320     },
    321   }
    322 
    323 
    324 Returns:
    325   An object of the form:
    326 
    327     { # JSON template for an Analytics Entity-User Link. Returns permissions that a user has for an entity.
    328       "kind": "analytics#entityUserLink", # Resource type for entity user link.
    329       "entity": { # Entity for this link. It can be an account, a web property, or a view (profile).
    330         "accountRef": { # JSON template for a linked account. # Account for this link.
    331           "kind": "analytics#accountRef", # Analytics account reference.
    332           "href": "A String", # Link for this account.
    333           "id": "A String", # Account ID.
    334           "name": "A String", # Account name.
    335         },
    336         "profileRef": { # JSON template for a linked view (profile). # View (Profile) for this link.
    337           "kind": "analytics#profileRef", # Analytics view (profile) reference.
    338           "name": "A String", # Name of this view (profile).
    339           "internalWebPropertyId": "A String", # Internal ID for the web property to which this view (profile) belongs.
    340           "href": "A String", # Link for this view (profile).
    341           "webPropertyId": "A String", # Web property ID of the form UA-XXXXX-YY to which this view (profile) belongs.
    342           "id": "A String", # View (Profile) ID.
    343           "accountId": "A String", # Account ID to which this view (profile) belongs.
    344         },
    345         "webPropertyRef": { # JSON template for a web property reference. # Web property for this link.
    346           "kind": "analytics#webPropertyRef", # Analytics web property reference.
    347           "name": "A String", # Name of this web property.
    348           "internalWebPropertyId": "A String", # Internal ID for this web property.
    349           "href": "A String", # Link for this web property.
    350           "id": "A String", # Web property ID of the form UA-XXXXX-YY.
    351           "accountId": "A String", # Account ID to which this web property belongs.
    352         },
    353       },
    354       "userRef": { # JSON template for a user reference. # User reference.
    355         "kind": "analytics#userRef",
    356         "email": "A String", # Email ID of this user.
    357         "id": "A String", # User ID.
    358       },
    359       "id": "A String", # Entity user link ID
    360       "selfLink": "A String", # Self link for this resource.
    361       "permissions": { # Permissions the user has for this entity.
    362         "local": [ # Permissions that a user has been assigned at this very level. Does not include any implied or inherited permissions. Local permissions are modifiable.
    363           "A String",
    364         ],
    365         "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.
    366           "A String",
    367         ],
    368       },
    369     }</pre>
    370 </div>
    371 
    372 </body></html>