Profile User Links: insert

Autorisierung erforderlich

Fügt der angegebenen Datenansicht (Profil) einen neuen Nutzer hinzu. Probieren Sie es gleich aus oder sehen Sie sich ein Beispiel an.

Bei dieser Methode werden zusätzlich zu den Standardparametern die in der Parametertabelle aufgeführten Parameter unterstützt.

Anfragen

HTTP-Anfrage

POST https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks

Parameter

Parametername Wert Beschreibung
Pfadparameter
accountId string Konto-ID, für die die Nutzerverknüpfung erstellt werden soll.
profileId string ID der Datenansicht (Profil), für die der Nutzerlink erstellt werden soll.
webPropertyId string Web-Property-ID, für die die Nutzerverknüpfung erstellt werden soll.

Autorisierung

Für diese Anfrage ist eine Autorisierung im folgenden Bereich erforderlich. Weitere Informationen zur Authentifizierung und Autorisierung

Bereich
https://www.googleapis.com/auth/analytics.manage.users

Anfragetext

Geben Sie im Anfragetext eine Ressource vom Typ „management.entityUserLink“ an.

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine management.entityUserLink-Ressource im Antworttext zurückgegeben.

Beispiele

Hinweis: Bei den für diese Methode verfügbaren Codebeispielen sind nicht alle unterstützten Programmiersprachen vertreten. Eine Liste der unterstützten Sprachen finden Sie auf der Seite für Clientbibliotheken.

Java

Verwendet die Java-Clientbibliothek.

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

/*
 * This request creates a new View (Profile) User Link.
 */

// Construct the user reference object.
UserRef userRef = new UserRef();
userRef.setEmail("liz@gmail.com");

// Construct the permissions object.
Permissions permissions = new Permissions();
List<String> local = Arrays.asList("EDIT", "MANAGE_USERS");
permissions.setLocal(local);

// Construct the body of the request
EntityUserLink body = new EntityUserLink();
body.setPermissions(permissions);
body.setUserRef(userRef);

try {
  analytics.management().profileUserLinks().insert("123456", "UA-123456-1",
      "7654321", body).execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

PHP

Verwendet die PHP-Clientbibliothek.

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

// Create the user reference.
$userRef = new Google_Service_Analytics_UserRef();
$userRef->setEmail('liz@gmail.com');

// Create the permissions object.
$permissions = new Google_Service_Analytics_EntityUserLinkPermissions();
$permissions->setLocal(array('COLLABORATE', 'READ_AND_ANALYZE'));

// Create the view (profile) user link.
$link = new Google_Service_Analytics_EntityUserLink();
$link->setPermissions($permissions);
$link->setUserRef($userRef);

// This request creates a new View (Profile) User Link.
try {
  $analytics->management_profileUserLinks->insert('123456', 'UA-123456-1',
      '756321', $link);
} 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();
}


Python

Verwendet die Python-Clientbibliothek.

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

# This request creates a new Profile User Link.
try:
  analytics.management().profileUserLinks().insert(
      accountId='123456',
      webPropertyId='UA-123456-1',
      profileId='7654321',
      body={
          'permissions': {
              'local': [
                  'EDIT',
                  'MANAGE_USERS'
              ]
          },
          'userRef': {
              'email': 'liz@gmail.com'
          }
      }
  ).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))

JavaScript

Es wird die JavaScript-Clientbibliothek verwendet.

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

/*
 * This request creates a new View (Profile) User Link.
 */
function insertProfileUserLink() {
  var request = gapi.client.analytics.management.profileUserLinks.insert(
    {
      'accountId': '123456',
      'webPropertyId': 'UA-123456-1',
      'profileId': '7654321',
      'resource': {
        'permissions': {
          'local': [
            'EDIT',
            'MANAGE_USERS'
          ]
        },
        'userRef': {
          'email': 'liz@gmail.com'
        }
      }
    });
  request.execute(function (response) { // Handle the response. });
}

Jetzt testen

Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen. Probieren Sie alternativ den eigenständigen Explorer aus.