データアクセス レコードのカスタマイズされたレポートを返します。このレポートには、ユーザーが Google アナリティクスのレポートデータを読み取るたびに記録が残ります。アクセス レコードは最長 2 年間保持されます。
データ アクセス レポートはプロパティに対してリクエストできます。レポートは任意のプロパティに対してリクエストできますが、割り当てに関連しないディメンションは Google アナリティクス 360 プロパティでのみリクエストできます。この方法は管理者のみが利用できます。
これらのデータアクセス レコードには、GA UI レポート、GA UI データ探索、GA Data API など、リンクを介して Google アナリティクスからデータを取得できる Firebase や AdMob などのプロダクトが含まれます。これらのレコードには、ストリームの追加やプロパティのタイムゾーンの変更など、プロパティの構成変更は含まれません。構成変更履歴については、searchChangeHistoryEvents をご覧ください。
この API に関するフィードバックをお送りいただくには、Google アナリティクス アクセス レポートに関するフィードバック フォームにご記入ください。
HTTP リクエスト
POST https://analyticsadmin.googleapis.com/v1alpha/{entity=accounts/*}:runAccessReport
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
entity |
データアクセス レポートは、プロパティ単位またはアカウント単位でのリクエストに対応しています。アカウント単位でリクエストされた場合、データ アクセス レポートには、そのアカウントのすべてのプロパティに対するすべてのアクセスが含まれます。 プロパティ単位でリクエストする場合、エンティティは「properties/123」のようにします(「123」は Google アナリティクスのプロパティ ID です)。アカウント単位でリクエストする場合、エンティティは「accounts/1234」のように指定します(「1234」は Google アナリティクス アカウント ID です)。 |
リクエストの本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{ "dimensions": [ { object ( |
フィールド | |
---|---|
dimensions[] |
リクエストされ、レスポンスに表示されるディメンション。リクエストで指定できるディメンションは最大 9 個です。 |
metrics[] |
リクエストされ、レスポンスに表示される指標。リクエストで指定できる指標は最大 10 個です。 |
date |
読み取るアクセス レコードの期間。複数の期間がリクエストされた場合、各レスポンス行にはゼロベースの期間インデックスが含まれます。2 つの期間が重複する場合、重複する日付のアクセス レコードは、両方の期間のレスポンスの行に含まれます。リクエストで指定できる期間は最大 2 つです。 |
dimension |
ディメンション フィルタを使用すると、フィルタに一致する特定のディメンション値にレポートのレスポンスを制限できます。たとえば、1 人のユーザーのアクセス レコードでフィルタする場合などです。詳細については、ディメンション フィルタの基本で例をご覧ください。このフィルタでは指標を使用できません。 |
metric |
指標フィルタを使用すると、フィルタに一致する特定の指標値にレポートのレスポンスを制限できます。指標フィルタは、SQL の HAVING 句と同様に、レポートの行の集計後に適用されます。このフィルタではディメンションを使用できません。 |
offset |
開始行の行数。最初の行は行 0 としてカウントされます。オフセットが指定されていない場合、オフセットは 0 として扱われます。オフセットがゼロの場合、このメソッドは このページネーション パラメータの詳細については、ページネーションをご覧ください。 |
limit |
返す行数。指定しない場合、10,000 行が返されます。API は、リクエストする行数に関係なく、リクエストごとに最大 100,000 行を返します。
このページネーション パラメータの詳細については、ページネーションをご覧ください。 |
time |
このリクエストのタイムゾーン(指定されている場合)。指定しない場合、プロパティのタイムゾーンが使用されます。レポートの開始日と終了日は、リクエストのタイムゾーンに基づいて解釈されます。 IANA タイムゾーン データベース(https://www.iana.org/time-zones))の文字列形式(例:「America/New_York」、「Asia/Tokyo」)。 |
order |
レスポンスで行を並べ替える方法を指定します。 |
return |
このアナリティクス プロパティの割り当ての現在の状態を返すかどうかを切り替えます。割り当ては AccessQuota で返されます。アカウント単位のリクエストの場合は、このフィールドを false にする必要があります。 |
include |
省略可。API 呼び出しを行ったことが一度もないユーザーをレスポンスに含めるかどうかを決定します。true の場合、API 呼び出しを行ったかどうかにかかわらず、指定されたプロパティまたはアカウントにアクセスできるすべてのユーザーがレスポンスに含まれます。false の場合、API 呼び出しを行ったユーザーのみが含まれます。 |
expand |
省略可。ユーザー グループ内のユーザーを返すかどうかを決定します。このフィールドは、includeAllUsers が true に設定されている場合にのみ機能します。true の場合、指定されたプロパティまたはアカウントにアクセスできるすべてのユーザーが返されます。false の場合、直接アクセス権を持つユーザーのみが返されます。 |
レスポンスの本文
成功した場合、レスポンスの本文には RunAccessReportResponse
のインスタンスが含まれます。
認可スコープ
以下のいずれかの OAuth スコープが必要です。
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics.edit