Method: activity.query

Frühere Aktivitäten in Google Drive abfragen.

HTTP-Anfrage

POST https://driveactivity.googleapis.com/v2/activity:query

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "consolidationStrategy": {
    object (ConsolidationStrategy)
  },
  "pageSize": integer,
  "pageToken": string,
  "filter": string,

  // Union field key can be only one of the following:
  "itemName": string,
  "ancestorName": string
  // End of list of possible types for union field key.
}
Felder
consolidationStrategy

object (ConsolidationStrategy)

Details zum Zusammenfassen von zugehörigen Aktionen, aus denen die Aktivität besteht. Wird sie nicht konfiguriert, werden zusammengehörige Aktionen nicht zusammengefasst.
pageSize

integer

Die Mindestanzahl der Aktivitäten, die in der Antwort erwünscht sind. Der Server versucht, mindestens diese Menge zurückzugeben. Der Server gibt möglicherweise auch weniger Aktivitäten zurück, wenn eine Teilantwort bereit ist, bevor die Anfrage das Zeitlimit überschreitet. Wenn die Richtlinie nicht konfiguriert ist, wird ein Standardwert verwendet.
pageToken

string

Das Token identifiziert, welche Ergebnisseite zurückgegeben werden soll. Legen Sie diesen Wert auf den „nextPageToken“-Wert fest, der von einer vorherigen Abfrage zurückgegeben wird, um die folgende Ergebnisseite zu erhalten. Wird sie nicht konfiguriert, wird die erste Ergebnisseite zurückgegeben.
filter

string

Das Filtern nach Elementen, die von dieser Abfrageanfrage zurückgegeben wurden. Das Format des Filterstrings ist eine Abfolge von Ausdrücken, die durch ein optionales UND verknüpft sind, wobei jeder Ausdruck die Form „Feldoperatorwert“ hat.

Unterstützte Felder:

  • time: Verwendet numerische Operatoren für Datumswerte, entweder in Millisekunden seit dem 1. Januar 1970 oder im Format RFC 3339. Beispiele:

    • time > 1452409200000 AND time <= 1492812924310
    • time >= "2016-01-10T01:02:03-05:00"

  • detail.action_detail_case: Verwendet den Operator „has“ (:) und entweder einen Singularwert oder eine Liste zulässiger Aktionstypen, die in Klammern gesetzt und durch ein Leerzeichen getrennt sind. Wenn Sie ein Ergebnis aus der Antwort ausschließen möchten, stellen Sie dem Filterstring einen Bindestrich (-) voran. Beispiele:

    • detail.action_detail_case:RENAME
    • detail.action_detail_case:(CREATE RESTORE)
    • -detail.action_detail_case:MOVE
Union-Feld key. Primäre Kriterien in der Abfrage. Wenn kein Schlüssel angegeben ist, ist die Standardeinstellung „AncestorName = items/root“. Für key ist nur einer der folgenden Werte zulässig:
itemName

string

Gibt Aktivitäten für dieses Drive-Element zurück. Das Format dafür ist items/ITEM_ID.
ancestorName

string

Gibt die Aktivitäten für diesen Drive-Ordner sowie alle untergeordneten Elemente und untergeordneten Elemente zurück. Das Format dafür ist items/ITEM_ID.

Antworttext

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

Antwortnachricht zum Abfragen der Drive-Aktivität.

JSON-Darstellung 
{
  "activities": [
    {
      object (DriveActivity)
    }
  ],
  "nextPageToken": string
}
Felder
activities[]

object (DriveActivity)

Liste der angeforderten Aktivitäten.
nextPageToken

string

Token zum Abrufen der nächsten Ergebnisseite. Leer, wenn keine weiteren Ergebnisse in der Liste vorhanden sind.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/drive.activity
  • https://www.googleapis.com/auth/drive.activity.readonly

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.

Konsolidierungsstrategie

Wie die einzelnen Aktivitäten konsolidiert werden Wenn mehrere Aktivitäten miteinander verknüpft sind, können sie in einer kombinierten Aktivität zusammengefasst werden, z. B. wenn ein Nutzer dieselbe Aktion für mehrere Ziele ausführt oder mehrere Aktionen für ein einzelnes Ziel. Mit der Strategie werden die Regeln definiert, für die Aktivitäten verknüpft sind.

JSON-Darstellung 
{

  // Union field strategy can be only one of the following:
  "none": {
    object (NoConsolidation)
  },
  "legacy": {
    object (Legacy)
  }
  // End of list of possible types for union field strategy.
}
Felder
Union-Feld strategy. Wie die einzelnen Aktivitäten konsolidiert werden Für strategy ist nur einer der folgenden Werte zulässig:
none

object (NoConsolidation)

Die einzelnen Aktivitäten werden nicht konsolidiert.
legacy

object (Legacy)

Die einzelnen Aktivitäten werden mithilfe der bisherigen Strategie konsolidiert.

Keine Konsolidierung

Eine Strategie, bei der einzelne Aktivitäten nicht zusammengeführt werden.

Legacy

Eine Strategie, bei der Aktivitäten mithilfe der Gruppierungsregeln aus der alten V1 Activity API konsolidiert werden. Ähnliche Aktionen innerhalb eines Zeitfensters können über mehrere Ziele (z. B. das Verschieben einer Gruppe von Dateien gleichzeitig) oder mehrere Aktionen (z. B. mehrere Nutzer, die dasselbe Element bearbeiten) gruppiert werden. Die Gruppierungsregeln für diese Strategie sind spezifisch für den jeweiligen Aktionstyp.