Method: activity.query

Bisherige 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 verwandter Aktionen, aus denen die Aktivität besteht. Wenn diese Option nicht festgelegt ist, werden ähnliche Aktionen nicht zusammengefasst.
pageSize

integer

Die Mindestanzahl der gewünschten Aktivitäten in der Antwort. Der Server versucht, mindestens diese Anzahl zurückzugeben. Der Server gibt möglicherweise auch weniger Aktivitäten zurück, wenn er eine teilweise Antwort bereit hat, bevor die Anfrage das Zeitlimit überschreitet. Wenn nicht festgelegt, wird ein Standardwert verwendet.
pageToken

string

Das Token gibt an, welche Ergebnisseite zurückgegeben werden soll. Legen Sie diesen Wert auf den Wert „nextPageToken“ fest, der von einer vorherigen Anfrage zurückgegeben wurde, um die nächste Seite mit Ergebnissen abzurufen. Wenn nicht festgelegt, wird die erste Ergebnisseite zurückgegeben.
filter

string

Die Filterung für Elemente, die von dieser Abfrageanfrage zurückgegeben werden. Das Format des Filterstrings ist eine Sequenz von Ausdrücken, die durch ein optionales „AND“ verbunden sind. Jeder Ausdruck hat das Format „Feldoperatorwert“.

Unterstützte Felder:

  • time: Verwendet numerische Operatoren für Datumswerte, entweder in Millisekunden seit dem 1. Januar 1970 oder im RFC 3339-Format. 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 einzelnen Wert oder eine Liste zulässiger Aktionstypen in Klammern, die durch ein Leerzeichen getrennt sind. Wenn Sie ein Ergebnis aus der Antwort ausschließen möchten, setzen 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. Die primären Kriterien in der Anfrage. Der Standardwert ist ancestorName = items/root, wenn kein Schlüssel angegeben ist. 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 Aktivitäten für diesen Drive-Ordner sowie alle untergeordneten Elemente und Nachfolger zurück. Das Format dafür ist items/ITEM_ID.

Antworttext

Antwortnachricht für das Abfragen von Drive-Aktivitäten.

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

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 Autorisierungsleitfaden.

ConsolidationStrategy

Wie die einzelnen Aktivitäten zusammengefasst werden. Wenn eine Reihe von Aktivitäten zusammengehört, können sie in einer kombinierten Aktivität zusammengefasst werden, z. B. wenn ein Akteur dieselbe Aktion für mehrere Ziele ausführt oder mehrere Akteure dieselbe Aktion für ein einzelnes Ziel ausführen. In der Strategie werden die Regeln dafür definiert, welche Aktivitäten in Beziehung gesetzt werden.

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 zusammengefasst werden. Für strategy ist nur einer der folgenden Werte zulässig:
none

object (NoConsolidation)

Die einzelnen Aktivitäten werden nicht zusammengefasst.
legacy

object (Legacy)

Die einzelnen Aktivitäten werden mit der alten Strategie zusammengefasst.

NoConsolidation

Dieser Typ hat keine Felder.

Eine Strategie, bei der einzelne Aktivitäten nicht zusammengefasst werden.

Legacy

Dieser Typ hat keine Felder.

Eine Strategie, bei der Aktivitäten mithilfe der Gruppierungsregeln der alten V1 Activity API zusammengefasst werden. Ähnliche Aktionen, die innerhalb eines bestimmten Zeitraums erfolgen, können über mehrere Ziele hinweg gruppiert werden, z. B. wenn eine Reihe von Dateien gleichzeitig verschoben wird, oder über mehrere Akteure hinweg, z. B. wenn mehrere Nutzer dasselbe Element bearbeiten. Die Gruppierungsregeln für diese Strategie sind für jede Art von Aktion spezifisch.