Method: activity.query

Wykonywanie zapytań dotyczących wcześniejszej aktywności na Dysku Google.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "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.
}
Pola
consolidationStrategy

object (ConsolidationStrategy)

Szczegóły dotyczące konsolidowania powiązanych działań, które wchodzą w skład działania. Jeśli jej nie skonfigurujesz, powiązane działania nie będą skonsolidowane.
pageSize

integer

Minimalna liczba działań wymagana w odpowiedzi. Serwer próbuje zwrócić co najmniej tę liczbę. Serwer może też zwracać mniej działań, jeśli ma częściową odpowiedź gotową przed upłynięciem limitu czasu żądania. Jeśli zasada nie jest skonfigurowana, używana jest wartość domyślna.
pageToken

string

Token określa, którą stronę wyników należy zwrócić. Aby uzyskać następną stronę z wynikami, ustaw ją na wartość nextPageToken zwracaną przez poprzednie zapytanie. Jeśli zasada nie jest skonfigurowana, zwracana jest pierwsza strona wyników.
filter

string

Filtrowanie elementów zwróconych w odpowiedzi na to żądanie. Format ciągu filtra to sekwencja wyrażeń połączonych opcjonalną operatorem „AND”, gdzie każde wyrażenie ma postać „wartość operatora pola”.

Obsługiwane pola:

  • time: używa operatorów numerycznych w przypadku wartości daty w milisekundach od 1 stycznia 1970 r. lub w formacie RFC 3339. Przykłady:

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

  • detail.action_detail_case: używa operatora „has” (:) oraz pojedynczej wartości lub listy dozwolonych typów działań ujętych w nawiasy i rozdzielonych spacją. Aby wykluczyć wynik z odpowiedzi, na początku ciągu filtra dodaj łącznik (-). Przykłady:

    • detail.action_detail_case:RENAME
    • detail.action_detail_case:(CREATE RESTORE)
    • -detail.action_detail_case:MOVE
Pole sumy key. Podstawowe kryteria w zapytaniu. Jeśli nie określono żadnego klucza, wartością domyślną jest element ancestorName = items/root. key może mieć tylko jedną z tych wartości:
itemName

string

Zwróć aktywność dla tego elementu na Dysku. Format to items/ITEM_ID.
ancestorName

string

Zwraca działania dotyczące tego folderu na Dysku oraz wszystkich jego elementów podrzędnych i potomnych. Format to items/ITEM_ID.

Treść odpowiedzi

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Komunikat z odpowiedzią na zapytanie o aktywność na Dysku.

Zapis JSON 
{
  "activities": [
    {
      object (DriveActivity)
    }
  ],
  "nextPageToken": string
}
Pola
activities[]

object (DriveActivity)

Lista aktywności, do których zgłoszono prośbę.
nextPageToken

string

Token do pobrania następnej strony wyników lub pusty, jeśli na liście nie ma więcej wyników.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

Więcej informacji znajdziesz w przewodniku po autoryzacji.

ConsolidationStrategy

Sposób konsolidowania poszczególnych działań. Jeśli zbiór działań jest powiązany, można je połączyć w jedną połączoną aktywność, np. wykonanie tego samego działania przez jednego użytkownika na wielu celach lub wykonanie tego samego działania przez wielu użytkowników w przypadku jednego celu. Strategia definiuje reguły, z którymi powiązane są działania.

Zapis JSON 
{

  // 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.
}
Pola
Pole sumy strategy. Sposób konsolidowania poszczególnych działań. strategy może mieć tylko jedną z tych wartości:
none

object (NoConsolidation)

Poszczególne działania nie są konsolidowane.
legacy

object (Legacy)

Poszczególne działania zostały scalone za pomocą starszej strategii.

NoConsolidation

Strategia, która nie łączy poszczególnych działań.

Starsza

Strategia, która konsoliduje działania za pomocą reguł grupowania ze starszej wersji interfejsu Activity API w wersji 1. Podobne działania wykonywane w określonym przedziale czasu można grupować w ramach wielu celów (np. jednoczesne przenoszenie zestawu plików) lub wielu podmiotów (np. kilku użytkowników edytujących ten sam element). Reguły grupowania w tej strategii są określone dla poszczególnych typów działań.