承認が必要です
ユーザーがアクセスできるビュー(旧プロファイル)を一覧表示します。 こちらから今すぐお試しいただけます。または、例をご覧ください。
標準パラメータに加えて、このメソッドはパラメータ表に示されているパラメータをサポートしています。
リクエスト
HTTP リクエスト
GET https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/profiles
パラメータ
パラメータ名 | 値 | 説明 |
---|---|---|
パスパラメータ | ||
accountId |
string |
取得するビューのアカウント ID。特定のアカウント ID か、ユーザーがアクセスできるすべてのアカウントを参照する「~all」。 |
webPropertyId |
string |
取得するビューのウェブ プロパティ ID。特定のウェブ プロパティ ID か、ユーザーがアクセスできるすべてのウェブ プロパティを参照する「~all」。 |
省略可能なクエリ パラメータ | ||
max-results |
integer |
このレスポンスに含めるビューの最大数。 |
start-index |
integer |
最初に取得するエンティティのインデックス。このパラメータは、max-results パラメータと共に改ページ メカニズムとして使用します。
|
承認
このリクエストは、少なくとも以下のスコープの 1 つによって承認される必要があります(詳細については、認証と承認に関する記事をご覧ください)。
スコープ |
---|
https://www.googleapis.com/auth/analytics |
https://www.googleapis.com/auth/analytics.edit |
https://www.googleapis.com/auth/analytics.readonly |
リクエスト本文
このメソッドをリクエストの本文に含めないでください。
レスポンス
レスポンスには、リクエストされたプロファイルごとにプロファイル リソースが 1 つ含まれます。
{ "kind": "analytics#profiles", "username": string, "totalResults": integer, "startIndex": integer, "itemsPerPage": integer, "previousLink": string, "nextLink": string, "items": [ management.profiles Resource ] }
プロパティ名 | 値 | 説明 | 備考 |
---|---|---|---|
kind |
string |
コレクション タイプ。値は「analytics#profiles」です。 | |
username |
string |
認証されたユーザーのメール ID。 | |
totalResults |
integer |
クエリに対する結果の合計数。レスポンス内の結果の数とは関係ありません。 | |
startIndex |
integer |
リソースの開始インデックス。デフォルトでは 1 で、それ以外の場合は start-index クエリ パラメータに指定された数になります。 | |
itemsPerPage |
integer |
レスポンスに含めることができるリソースの最大数。実際に返されたリソースの数とは関係ありません。値の範囲は 1 から 1,000 です。デフォルトでは 1,000 で、それ以外の場合は max-results クエリ パラメータで指定された数になります。 | |
previousLink |
string |
このビュー コレクションの前のページへのリンク。 | |
nextLink |
string |
このビュー コレクションの次のページへのリンクします。 | |
items[] |
list |
ビューのリスト。 |
例
注: このメソッドで使用可能なコード例では、サポートされているプログラミング言語すべての例を示しているわけではありません(サポートされている言語の一覧については、クライアント ライブラリ ページをご覧ください)。
Java
Java クライアント ライブラリを使用します。
/** * Note: This code assumes you have an authorized Analytics service object. * See the View (Profile) Developer Guide for details. */ /** * Example #1: * Requests a list of views (profiles) for the authorized user. */ try { Profiles profiles = analytics.management.profiles.list("12345", "UA-12345-1").execute(); } catch (GoogleJsonResponseException e) { System.err.println("There was a service error: " + e.getDetails().getCode() + " : " + e.getDetails().getMessage()); } /** * Example #2: * Retrieves views (profiles) for all properties of the user's account, * using a wildcard '~all' as the webpropertyId. */ Profiles profiles = analytics.management.profiles.list("12345", "~all").execute(); /** * Example #3: * The results of the list method are stored in the profiles object. * The following code shows how to iterate through them. */ for (Profile profile : profiles.getItems()) { System.out.println("Account ID: " + profile.getAccountId()); System.out.println("Property ID: " + profile.getWebPropertyId()); System.out.println("Property Internal ID: " + profile.getInternalWebPropertyId()); System.out.println("View (Profile) ID: " + profile.getId()); System.out.println("View (Profile) Name: " + profile.getName()); System.out.println("View (Profile) defaultPage: " + profile.getDefaultPage()); System.out.println("View (Profile) Exclude Query Parameters: " + profile.getExcludeQueryParameters()); System.out.println("View (Profile) Site Search Query Parameters: " + profile.getSiteSearchQueryParameters()); System.out.println("View (Profile) Site Search Category Parameters: " + profile.getSiteSearchCategoryParameters()); System.out.println("View (Profile) Currency: " + profile.getCurrency()); System.out.println("View (Profile) Timezone: " + profile.getTimezone()); System.out.println("View (Profile) Created: " + profile.getCreated()); System.out.println("View (Profile) Updated: " + profile.getUpdated()); System.out.println("View (Profile) eCommerce Tracking: " + profile.getECommerceTracking()); System.out.println("View (Profile) Enhanced eCommerce Tracking: " + profile.getEnhancedECommerceTracking()); }
PHP
PHP クライアント ライブラリを使用します。
/** * Note: This code assumes you have an authorized Analytics service object. * See the View (Profile) Developer Guide for details. */ /** * Example #1: * Requests a list of views (profiles) for the authorized user. */ try { $profiles = $analytics->management_profiles ->listManagementProfiles('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: * Retrieves views (profiles) for all properties of the user's account, * using a wildcard '~all' as the webpropertyId. */ $profiles = $analytics->management_profiles ->listManagementProfiles('123456', '~all'); /** * Example #3: * The results of the list method are stored in the profiles object. * The following code shows how to iterate through them. */ foreach ($profiles->getItems() as $profile) { $html = <<<HTML <pre> Account id = {$profile->getAccountId()} Property id = {$profile->getWebPropertyId()} View (Profile) id = {$profile->getId()} View (Profile) name = {$profile->getName()} View (Profile) type = {$profile->getType()} Default page = {$profile->getDefaultPage()} Exclude query parameters = {$profile->getExcludeQueryParameters()} Site search category parameters = {$profile->getSiteSearchCategoryParameters()} Currency = {$profile->getCurrency()} Timezone = {$profile->getTimezone()} Created = {$profile->getCreated()} Updated = {$profile->getUpdated()} eCommerce tracking = {$profile->getECommerceTracking()} Enhanced eCommerce Tracking = {$profile->getEnhancedECommerceTracking()} </pre> HTML; print $html; }
Python
Python クライアント ライブラリを使用します。
# Note: This code assumes you have an authorized Analytics service object. # See the View (Profile) Developer Guide for details. # Example #1: # Requests a list of views (profiles) for the authorized user. try: profiles = analytics.management().profiles().list( accountId='12345', webPropertyId='UA-12345-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: # Retrieves views (profiles) for all properties of the user's account, # using a wildcard '~all' as the webpropertyId. profiles = analytics.management().profiles().list(accountId='12345', webPropertyId='~all' ).execute() # Example #3: # The results of the list method are stored in the profiles object. # The following code shows how to iterate through them. for profile in profiles.get('items', []): print 'Account ID = %s' % profile.get('accountId') print 'Property ID = %s' % profile.get('webPropertyId') print 'Internal Property ID = %s' % profile.get('internalWebPropertyId') print 'View (Profile ID) = %s' % profile.get('id') print 'View (Profile) Name = %s' % profile.get('name') print 'Default Page = %s' % profile.get('defaultPage') print 'Exclude Query Parameters = %s' % profile.get( 'excludeQueryParameters') print 'Site Search Category Parameters = %s' % profile.get( 'siteSearchCategoryParameters') print 'Site Search Query Parameters = %s' % profile.get( 'siteSearchQueryParameters') print 'Currency = %s' % profile.get('currency') print 'Timezone = %s' % profile.get('timezone') print 'Created = %s' % profile.get('created') print 'Updated = %s' % profile.get('updated') print 'eCommerce Tracking = %s' % profile.get('eCommerceTracking') print 'Enhanced eCommerce Tracking = %s' % profile.get( 'enhancedECommerceTracking')
JavaScript
JavaScript クライアント ライブラリを使用します。
/* * Note: This code assumes you have an authorized Analytics client object. * See the View (Profiles) Developer Guide for details. */ /* * Example 1: * Requests a list of all View (Profiles) for the authorized user. */ function listViews() { var request = gapi.client.analytics.management.profiles.list({ 'accountId': '123456', 'webPropertyId': 'UA-123456-1' }); request.execute(printViews); } /* * Example 2: * The results of the list method are passed as the results object. * The following code shows how to iterate through them. */ function printViews(results) { if (results && !results.error) { var profiles = results.items; for (var i = 0, profile; profile = profiles[i]; i++) { console.log('Account Id: ' + profile.accountId); console.log('Property Id: ' + profile.webPropertyId); console.log('Internal Property Id: ' + profile.internalWebPropertyId); console.log('View (Profile) Id: ' + profile.id); console.log('View (Profile) Name: ' + profile.name); console.log('Default Page: ' + profile.defaultPage); console.log('Exclude Query Parameters: ' + profile.excludeQueryParameters); console.log('Site Search Category Parameters' + profile.siteSearchCategoryParameters); console.log('Site Search Query Parameters: ' + profile.siteSearchQueryParameters); console.log('Currency: ' + profile.currency); console.log('Timezone: ' + profile.timezone); console.log('Created: ' + profile.created); console.log('Updated: ' + profile.updated); } } }
試してみる
リアルタイムのデータでこのメソッドを呼び出してレスポンスを確認するには、以下の APIs Explorer か、スタンドアロンのテストツールをご利用ください。