Google ドライブの過去のアクティビティをクエリする。
HTTP リクエスト
POST https://driveactivity.googleapis.com/v2/activity:query
この URL は gRPC Transcoding 構文を使用します。
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{ "consolidationStrategy": { object ( |
フィールド | |
---|---|
consolidationStrategy |
アクティビティを構成する関連アクションを統合する方法の詳細。設定しない場合、関連するアクションは統合されません。 |
pageSize |
レスポンスで必要なアクティビティの最小数。サーバーは少なくともこの数を返そうとします。リクエストがタイムアウトになる前に部分レスポンスの準備が完了している場合は、サーバーが返すアクティビティの数も少なくなる可能性があります。設定しない場合は、デフォルト値が使用されます。 |
pageToken |
このトークンは、返される結果のページを識別します。結果の次のページを取得するには、前のクエリで返された nextPageToken の値に設定します。設定されていない場合は、結果の最初のページが返されます。 |
filter |
このクエリ リクエストから返されたアイテムのフィルタリング。フィルタ文字列の形式は、オプションの「AND」で結合された一連の式です。各式は「フィールド演算子値」の形式です。 サポートされているフィールド:
|
共用体フィールド key 。クエリの主な条件です。キーが指定されていない場合のデフォルトは、祖先 Name = items/root です。key は次のいずれかになります。 |
|
itemName |
このドライブ アイテムの返品アクティビティ。形式は |
ancestorName |
このドライブ フォルダと、すべての子と子孫の戻り値。形式は |
レスポンスの本文
成功すると、レスポンスの本文に次の構造のデータが含まれます。
ドライブのアクティビティをクエリすることに対するレスポンス メッセージ。
JSON 表現 |
---|
{
"activities": [
{
object ( |
フィールド | |
---|---|
activities[] |
リクエストされたアクティビティのリスト。 |
nextPageToken |
結果の次のページを取得するためのトークン。リストにそれ以上の結果がない場合は空です。 |
認可スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/drive.activity
https://www.googleapis.com/auth/drive.activity.readonly
詳細については、承認ガイドをご覧ください。
ConsolidationStrategy
個々の活動を統合する方法。1 つのアクターが複数のターゲットに対して同じアクションを実行する、または複数のアクターが 1 つのターゲットに対して同じアクションを実行するなど、一連のアクティビティが関連する場合は、1 つのアクティビティに統合できます。戦略は、どのアクティビティを関連付けるルールを定義するかを定義します。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド strategy 。個々の活動を統合する方法。strategy は次のいずれかになります。 |
|
none |
個々のアクティビティは統合されていません。 |
legacy |
個々の活動は従来の戦略を使用して統合されています。 |
NoConsolidation
個々のアクティビティを統合しない戦略。
レガシー
以前の V1 Activity API のグループ化ルールを使用してアクティビティを統合する戦略。一定の期間内に発生する同様のアクションは、複数のターゲット(一連のファイルを一度に移動するなど)または複数のアクター(複数のユーザーが同じアイテムを編集するなど)にまたがってグループ化できます。この戦略のグループ化ルールは、アクションのタイプごとに固有のものです。