نیاز به مجوز دارد
پیوندهای webProperty-user را برای یک ویژگی وب معین فهرست می کند. اکنون آن را امتحان کنید یا نمونه ای را ببینید .
علاوه بر پارامترهای استاندارد ، این روش از پارامترهای فهرست شده در جدول پارامترها پشتیبانی می کند.
درخواست
درخواست HTTP
GET https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/entityUserLinks
مولفه های
نام پارامتر | ارزش | شرح |
---|---|---|
پارامترهای مسیر | ||
accountId | string | شناسه حسابی که ویژگی وب داده شده به آن تعلق دارد. |
webPropertyId | string | شناسه Web Property برای پیوندهای کاربر webProperty برای بازیابی. میتواند یک شناسه خاص وب یا «~all» باشد، که به تمام ویژگیهای وب که کاربر به آنها دسترسی دارد اشاره دارد. |
پارامترهای پرس و جو اختیاری | ||
max-results | integer | حداکثر تعداد پیوندهای کاربر webProperty برای درج در این پاسخ. |
start-index | integer | فهرستی از اولین پیوند کاربر webProperty برای بازیابی. از این پارامتر به عنوان مکانیزم صفحه بندی به همراه پارامتر max-results استفاده کنید. |
مجوز
این درخواست به مجوز حداقل با یکی از حوزه های زیر نیاز دارد ( در مورد احراز هویت و مجوز بیشتر بخوانید ).
محدوده |
---|
https://www.googleapis.com/auth/analytics.manage.users |
https://www.googleapis.com/auth/analytics.manage.users.readonly |
درخواست بدن
با این روش بدنه درخواستی ارائه نکنید.
واکنش
در صورت موفقیت آمیز بودن، این روش یک بدنه پاسخ با ساختار زیر را برمی گرداند:
{ "kind": "analytics#entityUserLinks", "totalResults": integer, "startIndex": integer, "itemsPerPage": integer, "previousLink": string, "nextLink": string, "items": [ management.webpropertyUserLinks Resource ] }
نام ملک | ارزش | شرح | یادداشت |
---|---|---|---|
kind | string | نوع مجموعه | |
totalResults | integer | تعداد کل نتایج برای پرس و جو، صرف نظر از تعداد نتایج در پاسخ. | |
startIndex | integer | نمایه شروع ورودی ها که به طور پیش فرض 1 است یا توسط پارامتر جستجوی start-index مشخص شده است. | |
itemsPerPage | integer | حداکثر تعداد ورودیهایی که پاسخ میتواند داشته باشد، صرفنظر از تعداد واقعی ورودیهای برگشتی. مقدار آن از 1 تا 1000 با مقدار 1000 به طور پیش فرض متغیر است، یا در غیر این صورت توسط پارامتر query max-results مشخص شده است. | |
previousLink | string | پیوند قبلی برای این مجموعه حساب. | |
nextLink | string | پیوند بعدی برای این مجموعه حساب. | |
items[] | list | لیستی از پیوندهای کاربر موجودیت. |
مثال ها
توجه: نمونههای کد موجود برای این روش همه زبانهای برنامهنویسی پشتیبانیشده را نشان نمیدهند (برای فهرست زبانهای پشتیبانیشده به صفحه کتابخانههای سرویس گیرنده مراجعه کنید).
جاوا
از کتابخانه سرویس گیرنده جاوا استفاده می کند.
/* * 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 Property User Links for the authorized user. */ try { EntityUserLinks propertyLinks = analytics.management(). webPropertyUserLinks().list("123456", "UA-123456-1").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 propertyLinks object. * The following code shows how to iterate through them. */ for (EntityUserLink propertyUserLink : propertyLinks.getItems()) { Entity entity = propertyUserLink.getEntity(); WebPropertyRef webPropertyRef = entity.getWebPropertyRef(); UserRef userRef = propertyUserLink.getUserRef(); Permissions permissions = propertyUserLink.getPermissions(); System.out.println("Property User Link Id: " + propertyUserLink.getId()); System.out.println("Property 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("Property Id: " + webPropertyRef.getId()); System.out.println("Property Kind: " + webPropertyRef.getKind()); System.out.println("Property Name: " + webPropertyRef.getName()); }
PHP
از کتابخانه مشتری 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 property user links for the authorized user. */ try { $propertyUserlinks = $analytics->management_webpropertyUserLinks ->listManagementwebpropertyUserLinks('123456', 'UA-123456-1'); } 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 propertyUserlinks object. * The following code shows how to iterate through them. */ foreach ($propertyUserlinks->getItems() as $propertyUserLink) { $entity = $propertyUserLink->getEntity(); $propertyeRef = $entity->getWebPropertyRef(); $userRef = $propertyUserLink->getUserRef(); $permissions = $propertyUserLink->getPermissions(); $html = <<<HTML <pre> Property user link id = {$propertyUserLink->getId()} Property user link kind = {$propertyUserLink->getKind()} Property id = {$propertyeRef->getId()} Property name = {$propertyeRef->getName()} Property kind = {$propertyeRef->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; }
پایتون
از کتابخانه کلاینت پایتون استفاده می کند.
# 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 property user links for the authorized user. try: property_links = analytics.management().webpropertyUserLinks().list( accountId='123456', webPropertyId='UA-123456-1' ).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 property_links object. # The following code shows how to iterate through them. for propertyUserLink in property_links.get('items', []): entity = propertyUserLink.get('entity', {}) propertyRef = entity.get('webPropertyRef', {}) userRef = propertyUserLink.get('userRef', {}) permissions = propertyUserLink.get('permissions', {}) print 'Property User Link Id = %s' % propertyUserLink.get('id') print 'Property User Link Kind = %s' % propertyUserLink.get('kind') print 'User Email = %s' % userRef.get('email') print 'Permissions effective = %s' % permissions.get('effective') print 'Permissions local = %s' % permissions.get('local') print 'Property Id = %s' % propertyRef.get('id') print 'Property kind = %s' % propertyRef.get('kind') print 'Property Name = %s\n' % propertyRef.get('name')
جاوا اسکریپت
از کتابخانه سرویس گیرنده جاوا اسکریپت استفاده می کند.
/* * 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 Property User links for the authorized user. */ function listProfileUserLinks() { var request = gapi.client.analytics.management.webpropertyUserLinks.list({ 'accountId': '123456', 'webPropertyId': 'UA-123456-1' }); request.execute(printPropertyUserLinks); } /* * Example 2: * The results of the list method are passed as the results object. * The following code shows how to iterate through them. */ function printPropertyUserLinks(results) { if (results && !results.error) { var propertyLinks = results.items; for (var i = 0, userLink; userLink = propertyLinks[i]; i++) { var entity = userLink.entity; var propertyRef = entity.webPropertyRef; var userRef = userLink.userRef; var permissions = userLink.permissions; console.log('Property User Link Id: ' + userLink.id); console.log('Property User Link Kind: ' + userLink.kind); console.log('User Email: ' + userRef.email); console.log('Permissions effective: ' + permissions.effective); console.log('Permissions local: ' + permissions.local); console.log('Property Id: ' + propertyRef.id); console.log('Property Kind: ' + propertyRef.kind); console.log('Property Name: ' + propertyRef.name); } } }
آن را امتحان کنید!
از APIs Explorer زیر برای فراخوانی این روش در دادههای زنده و دیدن پاسخ استفاده کنید. از طرف دیگر، اکسپلورر مستقل را امتحان کنید.
نیاز به مجوز دارد
پیوندهای webProperty-user را برای یک ویژگی وب معین فهرست می کند. اکنون آن را امتحان کنید یا نمونه ای را ببینید .
علاوه بر پارامترهای استاندارد ، این روش از پارامترهای فهرست شده در جدول پارامترها پشتیبانی می کند.
درخواست
درخواست HTTP
GET https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/entityUserLinks
مولفه های
نام پارامتر | ارزش | شرح |
---|---|---|
پارامترهای مسیر | ||
accountId | string | شناسه حسابی که ویژگی وب داده شده به آن تعلق دارد. |
webPropertyId | string | شناسه Web Property برای پیوندهای کاربر webProperty برای بازیابی. میتواند یک شناسه خاص وب یا «~all» باشد، که به تمام ویژگیهای وب که کاربر به آنها دسترسی دارد اشاره دارد. |
پارامترهای پرس و جو اختیاری | ||
max-results | integer | حداکثر تعداد پیوندهای کاربر webProperty برای درج در این پاسخ. |
start-index | integer | فهرستی از اولین پیوند کاربر webProperty برای بازیابی. از این پارامتر به عنوان مکانیزم صفحه بندی به همراه پارامتر max-results استفاده کنید. |
مجوز
این درخواست به مجوز حداقل با یکی از حوزه های زیر نیاز دارد ( در مورد احراز هویت و مجوز بیشتر بخوانید ).
محدوده |
---|
https://www.googleapis.com/auth/analytics.manage.users |
https://www.googleapis.com/auth/analytics.manage.users.readonly |
درخواست بدن
با این روش بدنه درخواستی ارائه نکنید.
واکنش
در صورت موفقیت آمیز بودن، این روش یک بدنه پاسخ با ساختار زیر را برمی گرداند:
{ "kind": "analytics#entityUserLinks", "totalResults": integer, "startIndex": integer, "itemsPerPage": integer, "previousLink": string, "nextLink": string, "items": [ management.webpropertyUserLinks Resource ] }
نام ملک | ارزش | شرح | یادداشت |
---|---|---|---|
kind | string | نوع مجموعه | |
totalResults | integer | تعداد کل نتایج برای پرس و جو، صرف نظر از تعداد نتایج در پاسخ. | |
startIndex | integer | نمایه شروع ورودی ها که به طور پیش فرض 1 است یا توسط پارامتر جستجوی start-index مشخص شده است. | |
itemsPerPage | integer | حداکثر تعداد ورودیهایی که پاسخ میتواند داشته باشد، صرفنظر از تعداد واقعی ورودیهای برگشتی. مقدار آن از 1 تا 1000 با مقدار 1000 به طور پیش فرض متغیر است، یا در غیر این صورت توسط پارامتر query max-results مشخص شده است. | |
previousLink | string | پیوند قبلی برای این مجموعه حساب. | |
nextLink | string | پیوند بعدی برای این مجموعه حساب. | |
items[] | list | لیستی از پیوندهای کاربر موجودیت. |
مثال ها
توجه: نمونههای کد موجود برای این روش همه زبانهای برنامهنویسی پشتیبانیشده را نشان نمیدهند (برای فهرست زبانهای پشتیبانیشده به صفحه کتابخانههای سرویس گیرنده مراجعه کنید).
جاوا
از کتابخانه سرویس گیرنده جاوا استفاده می کند.
/* * 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 Property User Links for the authorized user. */ try { EntityUserLinks propertyLinks = analytics.management(). webPropertyUserLinks().list("123456", "UA-123456-1").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 propertyLinks object. * The following code shows how to iterate through them. */ for (EntityUserLink propertyUserLink : propertyLinks.getItems()) { Entity entity = propertyUserLink.getEntity(); WebPropertyRef webPropertyRef = entity.getWebPropertyRef(); UserRef userRef = propertyUserLink.getUserRef(); Permissions permissions = propertyUserLink.getPermissions(); System.out.println("Property User Link Id: " + propertyUserLink.getId()); System.out.println("Property 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("Property Id: " + webPropertyRef.getId()); System.out.println("Property Kind: " + webPropertyRef.getKind()); System.out.println("Property Name: " + webPropertyRef.getName()); }
PHP
از کتابخانه مشتری 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 property user links for the authorized user. */ try { $propertyUserlinks = $analytics->management_webpropertyUserLinks ->listManagementwebpropertyUserLinks('123456', 'UA-123456-1'); } 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 propertyUserlinks object. * The following code shows how to iterate through them. */ foreach ($propertyUserlinks->getItems() as $propertyUserLink) { $entity = $propertyUserLink->getEntity(); $propertyeRef = $entity->getWebPropertyRef(); $userRef = $propertyUserLink->getUserRef(); $permissions = $propertyUserLink->getPermissions(); $html = <<<HTML <pre> Property user link id = {$propertyUserLink->getId()} Property user link kind = {$propertyUserLink->getKind()} Property id = {$propertyeRef->getId()} Property name = {$propertyeRef->getName()} Property kind = {$propertyeRef->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; }
پایتون
از کتابخانه کلاینت پایتون استفاده می کند.
# 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 property user links for the authorized user. try: property_links = analytics.management().webpropertyUserLinks().list( accountId='123456', webPropertyId='UA-123456-1' ).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 property_links object. # The following code shows how to iterate through them. for propertyUserLink in property_links.get('items', []): entity = propertyUserLink.get('entity', {}) propertyRef = entity.get('webPropertyRef', {}) userRef = propertyUserLink.get('userRef', {}) permissions = propertyUserLink.get('permissions', {}) print 'Property User Link Id = %s' % propertyUserLink.get('id') print 'Property User Link Kind = %s' % propertyUserLink.get('kind') print 'User Email = %s' % userRef.get('email') print 'Permissions effective = %s' % permissions.get('effective') print 'Permissions local = %s' % permissions.get('local') print 'Property Id = %s' % propertyRef.get('id') print 'Property kind = %s' % propertyRef.get('kind') print 'Property Name = %s\n' % propertyRef.get('name')
جاوا اسکریپت
از کتابخانه سرویس گیرنده جاوا اسکریپت استفاده می کند.
/* * 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 Property User links for the authorized user. */ function listProfileUserLinks() { var request = gapi.client.analytics.management.webpropertyUserLinks.list({ 'accountId': '123456', 'webPropertyId': 'UA-123456-1' }); request.execute(printPropertyUserLinks); } /* * Example 2: * The results of the list method are passed as the results object. * The following code shows how to iterate through them. */ function printPropertyUserLinks(results) { if (results && !results.error) { var propertyLinks = results.items; for (var i = 0, userLink; userLink = propertyLinks[i]; i++) { var entity = userLink.entity; var propertyRef = entity.webPropertyRef; var userRef = userLink.userRef; var permissions = userLink.permissions; console.log('Property User Link Id: ' + userLink.id); console.log('Property User Link Kind: ' + userLink.kind); console.log('User Email: ' + userRef.email); console.log('Permissions effective: ' + permissions.effective); console.log('Permissions local: ' + permissions.local); console.log('Property Id: ' + propertyRef.id); console.log('Property Kind: ' + propertyRef.kind); console.log('Property Name: ' + propertyRef.name); } } }
آن را امتحان کنید!
از APIs Explorer زیر برای فراخوانی این روش در دادههای زنده و دیدن پاسخ استفاده کنید. از طرف دیگر، اکسپلورر مستقل را امتحان کنید.