Webproperty User Links: insert

Cần có uỷ quyền

Thêm người dùng mới vào thuộc tính web đã cho. Thử ngay hoặc xem ví dụ.

Ngoài các thông số chuẩn, phương thức này còn hỗ trợ các thông số được liệt kê trong bảng thông số.

Yêu cầu

Yêu cầu HTTP

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

Tham số

Tên thông số	Giá trị	Nội dung mô tả
Tham số đường dẫn
accountId	string	Mã tài khoản để tạo đường liên kết người dùng.
webPropertyId	string	Mã thuộc tính web để tạo đường liên kết người dùng.

Ủy quyền

Yêu cầu này cần được uỷ quyền với phạm vi sau (đọc thêm về việc xác thực và uỷ quyền).

Phạm vi
https://www.googleapis.com/auth/analytics.manage.users

Nội dung yêu cầu

Trong nội dung yêu cầu, hãy cung cấp một tài nguyênmanagement.entityUserLink.

Phản hồi

Nếu thành công, phương thức này sẽ trả về một tài nguyênmanagement.entityUserLink trong nội dung phản hồi.

Ví dụ

Lưu ý: Các đoạn mã mẫu của phương thức này không phải là ví dụ cho mọi ngôn ngữ lập trình được hỗ trợ (xem trang thông tin về các thư viện dùng cho ứng dụng để biết danh sách các ngôn ngữ được hỗ trợ).

Java

Sử dụng thư viện ứng dụng Java.

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

/*
 * This request creates a new Property User Link.
 */


// Construct the user reference object.
UserRef userRef = new UserRef();
userRef.setEmail("[e-mail]");

// 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().webpropertyUserLinks().insert("123456", "UA-123456-1",
      body).execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

1.199

Sử dụng thư viện ứng dụng PHP.

/**
* 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('[e-mail]');

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

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

// This request creates a new Property User Link.
try {
  $analytics->management_webpropertyUserLinks->insert('123456', 'UA-123456-1',
      $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

Sử dụng thư viện ứng dụng Python.

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

# This request creates a new Property User Link.
try:
  analytics.management().webpropertyUserLinks().insert(
      accountId='123456',
      webPropertyId='UA-123456-1',
      body={
          'permissions': {
              'local': [
                  'EDIT',
                  'MANAGE_USERS'
              ]
          },
          'userRef': {
              'email': '[e-mail]'
          }
      }
  ).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

Sử dụng thư viện ứng dụng JavaScript.

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

/*
 * This request creates a new Property User Link.
 */
function insertPropertyUserLink() {
  var request = gapi.client.analytics.management.webpropertyUserLinks.insert(
    {
      'accountId': '123456',
      'webPropertyId': 'UA-123456-1',
      'resource': {
        'permissions': {
          'local': [
            'EDIT',
            'MANAGE_USERS'
          ]
        },
        'userRef': {
          'email': '[e-mail]'
        }
      }
    });
  request.execute(function (response) { // Handle the response. });
}

Hãy dùng thử!

Sử dụng APIs Explorer bên dưới để gọi phương thức này trên dữ liệu trực tiếp và xem phản hồi. Ngoài ra, hãy dùng thử Trình khám phá độc lập.