Method: activity.query

Zapytanie o wcześniejszą aktywność 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)

Informacje o sposobie konsolidowania powiązanych działań, które składają się na aktywność. Jeśli jej nie skonfigurujesz, powiązane działania nie zostaną skonsolidowane.
pageSize

integer

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

string

Token określa stronę wyników do zwrócenia. Aby uzyskać kolejną stronę wyników, ustaw tę wartość na wartość nextPageToken zwrócona z poprzedniego zapytania. Jeśli zasada nie jest skonfigurowana, zwracana jest pierwsza strona wyników.
filter

string

Filtrowanie elementów zwróconych z tego żądania. Format ciągu znaków filtra to sekwencja wyrażeń połączonych opcjonalnym operatorem „ORAZ”, przy czym każde wyrażenie ma postać „wartość operatora pola”.

Obsługiwane pola:

  • time: używa operatorów liczbowych w wartościach 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 parametru „has” (:) oraz pojedynczą wartość lub listę dozwolonych typów działań ujętą w nawiasy i oddzieloną spacją. Aby wykluczyć wynik z odpowiedzi, dołącz na początku ciągu filtra łącznik (-). Przykłady:

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

string

Zwróć działania związane z tym elementem na Dysku. Format to items/ITEM_ID.
ancestorName

string

Działania związane z zwracaniem dla tego folderu na Dysku oraz wszystkich elementów podrzędnych i podrzędnych. Format to items/ITEM_ID.

Treść odpowiedzi

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

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

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

object (DriveActivity)

Żądana lista aktywności.
nextPageToken

string

Token pobierający następną stronę wyników lub pusty, jeśli na liście nie ma więcej wyników.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu OAuth:

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

Więcej informacji znajdziesz w przewodniku na temat autoryzacji.

ConsolidationStrategy

Sposób konsolidowania poszczególnych aktywności. Jeśli zestaw działań jest ze sobą powiązany, można je połączyć w jedną czynność, np. jeden podmiot wykonujący to samo działanie w odniesieniu do kilku celów lub kilka podmiotów wykonujących to samo działanie w odniesieniu do jednego celu. Definiuje ona 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 aktywności. strategy może mieć tylko jedną z tych wartości:
none

object (NoConsolidation)

Poszczególne aktywności nie są konsolidowane.
legacy

object (Legacy)

Poszczególne aktywności są konsolidowane przy użyciu starszej strategii.

NoConsolidation

Ten typ nie zawiera pól.

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

Starsza wersja

Ten typ nie zawiera pól.

Strategia konsolidująca działania za pomocą reguł grupowania ze starszej wersji interfejsu Activity API w wersji 1. Podobne działania wykonywane w danym przedziale czasu można zgrupować w kilku obszarach docelowych (np. przeniesienie zbioru plików naraz) lub przez kilku użytkowników (np. przez kilku użytkowników edytujących ten sam element). Reguły grupowania w tej strategii są specyficzne dla każdego typu działania.