Account User Links: list

Requiere autorización

Se muestran las vinculaciones de usuarios y cuentas de una cuenta determinada. Pruébalo ahora y ve un ejemplo.

Además de los parámetros estándar, este método admite los parámetros enumerados en la tabla de parámetros.

Solicitud

Solicitud HTTP

GET https://www.googleapis.com/analytics/v3/management/accounts/accountId/entityUserLinks

Parámetros

Nombre del parámetro	Valor	Descripción
Parámetros de ruta de acceso
`accountId`	`string`	ID de la cuenta para el que se recuperarán los vínculos del usuario.
Parámetros de consulta opcionales
`max-results`	`integer`	Es la cantidad máxima de vínculos de usuario de cuenta que se deben incluir en esta respuesta.
`start-index`	`integer`	Un índice del primer vínculo usuario-cuenta que se recuperará. Utiliza este parámetro como un mecanismo de paginación junto con el parámetro max-results.

Autorización

Esta solicitud requiere autorización con al menos uno de los siguientes alcances (obtén más información acerca de la autenticación y autorización).

Alcance
`https://www.googleapis.com/auth/analytics.manage.users`
`https://www.googleapis.com/auth/analytics.manage.users.readonly`

Cuerpo de la solicitud

No proporciones un cuerpo de la solicitud con este método.

Respuesta

Si se aplica correctamente, este método muestra un cuerpo de respuesta con la siguiente estructura:

{
  "kind": "analytics#entityUserLinks",
  "totalResults": integer,
  "startIndex": integer,
  "itemsPerPage": integer,
  "previousLink": string,
  "nextLink": string,
  "items": [
    management.accountUserLinks Resource
  ]
}

Nombre de la propiedad	Valor	Descripción
`kind`	`string`	Tipo de colección.
`totalResults`	`integer`	El número total de resultados para la consulta, sin importar el número de resultados en la respuesta.
`startIndex`	`integer`	El índice de inicio de las entradas, que es 1 de forma predeterminada o que el parámetro de consulta del índice de inicio lo especifica.
`itemsPerPage`	`integer`	La cantidad máxima de entradas que puede contener la respuesta, sin importar la cantidad real de entradas que se muestran. Su valor varía entre 1 y 1,000, con un valor de 1,000 de forma predeterminada o especificado en el parámetro de consulta max-results.
`previousLink`	`string`	Vínculo anterior de esta colección de cuentas.
`nextLink`	`string`	Siguiente vínculo de esta colección de cuentas.
`items[]`	`list`	Una lista de vínculos de usuarios de entidades.

Ejemplos

Nota: Los ejemplos de código disponibles para este método no representan todos los lenguajes de programación admitidos (consulta la página de bibliotecas cliente para consultar una lista de lenguajes admitidos).

Java

Usa la biblioteca cliente de Java.

/*
 * Note: This code assumes you have an authorized Analytics service object.
 * See the User Permissions Developer Guide for details.
 */

/*
 * Example #1:
 * This request lists all Account User Links for the authorized user.
 */
try {
  EntityUserLinks accountLinks = analytics.management().
      accountUserLinks().list("123456").execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

/**
 * Example #2:
 * The results of the list method are stored in the accountLinks object.
 * The following code shows how to iterate through them.
 */
for (EntityUserLink accountUserLink : accountLinks.getItems()) {
  Entity entity = accountUserLink.getEntity();
  AccountRef accountRef = entity.getAccountRef();
  UserRef userRef = accountUserLink.getUserRef();
  Permissions permissions = accountUserLink.getPermissions();

  System.out.println("Account User Link Id: " + accountUserLink.getId());
  System.out.println("Account User Link kind: " + userRef.getKind());
  System.out.println("User Email: " + userRef.getEmail());
  System.out.println("Permissions effective: " + permissions.getEffective());
  System.out.println("Permissions local: " + permissions.getLocal());
  System.out.println("Account Id: " + accountRef.getId());
  System.out.println("Account Kind: " + accountRef.getKind());
  System.out.println("Account Name: " + accountRef.getName());
}

PHP

Utiliza la biblioteca cliente PHP.

/**
* Note: This code assumes you have an authorized Analytics service object.
* See the User Permissions Developer Guide for details.
*/

/**
 * Example #1:
 * Requests a list of all account user links for the authorized user.
 */
try {
  $accountUserlinks = $analytics->management_accountUserLinks
      ->listManagementAccountUserLinks('123456');
} catch (apiServiceException $e) {
  print 'There was an Analytics API service error '
      . $e->getCode() . ':' . $e->getMessage();

} catch (apiException $e) {
  print 'There was a general API error '
      . $e->getCode() . ':' . $e->getMessage();
}

/**
 * Example #2:
 * The results of the list method are stored in the accountUserlinks object.
 * The following code shows how to iterate through them.
 */
foreach ($accountUserlinks->getItems() as $accountUserLink) {
  $entity = $accountUserLink->getEntity();
  $accountRef = $entity->getAccountRef();
  $userRef = $accountUserLink->getUserRef();
  $permissions = $accountUserLink->getPermissions();

  $html = <<<HTML
<pre>
Account user link id   = {$accountUserLink->getId()}
Account user link kind = {$accountUserLink->getKind()}

Account id   = {$accountRef->getId()}
Account name = {$accountRef->getName()}
Account kind = {$accountRef->getKind()}

Permissions local     = {$permissions->getLocal()}
Permissions effective = {$permissions->getEffective()}

User id    = {$userRef->getId()}
User kind  = {$userRef->getKind()}
user email = {$userRef->getEmail()}
</pre>
HTML;
  print $html;
}

Python

Usa la biblioteca cliente de Python.

# Note: This code assumes you have an authorized Analytics service object.
# See the User Permissions Developer Guide for details.

# Example #1:
# Requests a list of all account-user links for the authorized user.
try:
  account_links = analytics.management().accountUserLinks().list(
      accountId='123456'
  ).execute()

except TypeError, error:
  # Handle errors in constructing a query.
  print 'There was an error in constructing your query : %s' % error

except HttpError, error:
  # Handle API errors.
  print ('There was an API error : %s : %s' %
         (error.resp.status, error.resp.reason))


# Example #2:
# The results of the list method are stored in the account_links object.
# The following code shows how to iterate through them.
for accountUserLink in account_links.get('items', []):
  entity = accountUserLink.get('entity', {})
  accountRef = entity.get('accountRef', {})
  userRef = accountUserLink.get('userRef', {})
  permissions = accountUserLink.get('permissions', {})

  print 'Account User Link Id   = %s' % accountUserLink.get('id')
  print 'Account User Link kind = %s' % accountUserLink.get('kind')
  print 'User Email             = %s' % userRef.get('email')
  print 'Permissions effective  = %s' % permissions.get('effective')
  print 'Permissions local      = %s' % permissions.get('local')
  print 'Account Id             = %s' % accountRef.get('id')
  print 'Account Kind           = %s' % accountRef.get('kind')
  print 'Account Name           = %s\n' % accountRef.get('name')

JavaScript

Usa la biblioteca cliente de JavaScript.

/*
 * Note: This code assumes you have an authorized Analytics client object.
 * See the User Permissions Developer Guide for details.
 */

/*
 * Example 1:
 * Requests a list of all Account User links for the authorized user.
 */
function listAccountUserLinks() {
  var request = gapi.client.analytics.management.accountUserLinks.list({
      'accountId': '123456'
  });
  request.execute(printAccountUserLinks);
}

/*
 * Example 2:
 * The results of the list method are passed as the results object.
 * The following code shows how to iterate through them.
 */
function printAccountUserLinks(results) {
  if (results && !results.error) {
    var accountLinks = results.items;
    for (var i = 0, accountUserLink; accountUserLink = accountLinks[i]; i++) {
      var entity = accountUserLink.entity;
      var accountRef = entity.accountRef;
      var userRef = accountUserLink.userRef;
      var permissions = accountUserLink.permissions;

      console.log('Account User Link Id: ' + accountUserLink.id);
      console.log('Account User Link Kind: ' + accountUserLink.kind);
      console.log('User Email: ' + userRef.email);
      console.log('Permissions effective: ' + permissions.effective);
      console.log('Permissions local: ' + permissions.local);
      console.log('Account Id: ' + accountRef.id);
      console.log('Account Kind: ' + accountRef.kind);
      console.log('Account Name: ' + accountRef.name);
    }
  }
}

Pruébalo

Usa el Explorador de APIs que aparece a continuación para llamar a este método con los datos en tiempo real y ver la respuesta. También puedes probar el Explorador independiente.