نیاز به مجوز دارد
کاربر جدیدی را به نمای داده شده (نمایه) اضافه می کند. اکنون آن را امتحان کنید یا نمونه ای را ببینید .
علاوه بر پارامترهای استاندارد ، این روش از پارامترهای فهرست شده در جدول پارامترها پشتیبانی می کند.
درخواست
درخواست HTTP
POST https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks
مولفه های
نام پارامتر | ارزش | شرح |
---|---|---|
پارامترهای مسیر | ||
accountId | string | شناسه حساب برای ایجاد پیوند کاربر. |
profileId | string | مشاهده شناسه (نمایه) برای ایجاد پیوند کاربر. |
webPropertyId | string | شناسه مالکیت وب برای ایجاد پیوند کاربر برای. |
مجوز
این درخواست به مجوز با محدوده زیر نیاز دارد ( در مورد احراز هویت و مجوز بیشتر بخوانید ).
محدوده |
---|
https://www.googleapis.com/auth/analytics.manage.users |
درخواست بدن
در بدنه درخواست، یک منبع management.entityUserLink ارائه کنید.
واکنش
در صورت موفقیت آمیز بودن، این روش یک منبع management.entityUserLink را در بدنه پاسخ برمی گرداند.
مثال ها
توجه: نمونههای کد موجود برای این روش همه زبانهای برنامهنویسی پشتیبانیشده را نشان نمیدهند (برای فهرست زبانهای پشتیبانیشده به صفحه کتابخانههای سرویس گیرنده مراجعه کنید).
جاوا
از کتابخانه سرویس گیرنده جاوا استفاده می کند.
/* * 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
از کتابخانه مشتری 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('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(); }
پایتون
از کتابخانه کلاینت پایتون استفاده می کند.
# 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))
جاوا اسکریپت
از کتابخانه سرویس گیرنده جاوا اسکریپت استفاده می کند.
/* * 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. }); }
آن را امتحان کنید!
از APIs Explorer زیر برای فراخوانی این روش در دادههای زنده و دیدن پاسخ استفاده کنید. از طرف دیگر، اکسپلورر مستقل را امتحان کنید.