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 dazu, wie Sie ähnliche Aktionen zusammenführen, die die Aktivität ausmachen. Wenn diese Option nicht festgelegt ist, werden ähnliche Aktionen nicht zusammengefasst.
pageSize

integer

Die Mindestanzahl von in der Antwort gewünschten Aktivitäten; versucht der Server, mindestens diese Menge zurückzugeben. Der Server gibt möglicherweise auch weniger Aktivitäten zurück, wenn er vor Ablauf der Zeitüberschreitung eine teilweise Antwort bereit hat. 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 nextPageToken-Wert fest, der von einer vorherigen Abfrage zurückgegeben wurde, um die folgende Ergebnisseite zu erhalten. Wenn nichts festgelegt ist, wird die erste Ergebnisseite zurückgegeben.
filter

string

Die Filterung nach Elementen, die von dieser Anfrage zurückgegeben wurden. Der Filterstring besteht aus einer Sequenz von Ausdrücken, die durch ein optionales „AND“ verbunden sind. Jeder Ausdruck hat das Format „Feld Operator Wert“.

Unterstützte Felder:

  • time: Hier werden numerische Operatoren auf Datumswerte angewendet, die entweder in Millisekunden seit dem 1. Januar 1970 oder im RFC 3339-Format angegeben sind. Beispiele:

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

  • detail.action_detail_case: Verwendet das Zeichen "has" und entweder ein einzelner Wert oder eine Liste zulässiger Aktionstypen in Klammern, getrennt durch ein Leerzeichen. Um ein Ergebnis aus der Antwort auszuschließen, setzen Sie am Anfang des Filterstrings einen Bindestrich (-). Beispiele:

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

string

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

string

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

Antworttext

Antwortnachricht für die Abfrage 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 Leitfaden zur Autorisierung.

ConsolidationStrategy

Wie die einzelnen Aktivitäten zusammengefasst werden. Wenn mehrere Aktivitäten zusammenhängen, können sie zu einer kombinierten Aktivität zusammengefasst werden. Das ist beispielsweise der Fall, wenn ein Akteur dieselbe Aktion auf mehrere Ziele ausführt oder mehrere Akteure dieselbe Aktion auf ein einzelnes Ziel ausführen. Mit der Strategie werden die Regeln definiert, auf die sich Aktivitäten beziehen.

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 sind nicht konsolidiert.
legacy

object (Legacy)

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

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 aus der bisherigen Activity API V1 zusammengefasst werden. Ähnliche Aktionen, die innerhalb eines bestimmten Zeitraums stattfinden, können in mehrere Ziele (z. B. das gleichzeitige Verschieben mehrerer Dateien) oder mehrere Akteure (z. B. mehrere Nutzer, die dasselbe Element bearbeiten) gruppiert werden. Die Gruppierungsregeln für diese Strategie sind für jeden Aktionstyp spezifisch.