Zarządzanie zatwierdzeniami

Z tego dokumentu dowiesz się, jak zarządzać zatwierdzeniami w interfejsie Google Drive API.

Zatwierdzenia treści znajdziesz na Dysku Google. Interfejs Google Drive API udostępnia zasób approvals, dzięki któremu możesz pobierać i wyświetlać stan swoich zatwierdzeń. Metody zasobu approvals działają w przypadku elementów na Dysku, w Dokumentach Google i innych edytorach Google Workspace.

Możesz skorzystać z tego procesu, aby znaleźć zatwierdzenia w sytuacjach formalnego sprawdzania, takich jak sprawdzanie umowy lub oficjalnego dokumentu przed publikacją. Zatwierdzenie śledzi stan zarówno sprawdzania (np. w toku, zatwierdzono lub odrzucono), jak i osób sprawdzających. Zatwierdzenia to doskonały sposób na weryfikację treści i prowadzenie rejestru recenzentów.

Aby wyświetlić zatwierdzenia pliku, musisz mieć uprawnienia do odczytu jego metadanych. Więcej informacji znajdziesz w artykule Role i uprawnienia.

Używanie parametru fields

Jeśli chcesz określić pola, które mają być zwracane w odpowiedzi, możesz ustawić fields parametr systemfields w dowolnej metodzie zasobu approvals. Jeśli pominiesz parametr fields, serwer zwróci domyślny zestaw pól specyficznych dla danej metody. Aby zwrócić inne pola, zobacz Zwracanie określonych pól.

Uzyskiwanie zatwierdzenia

Aby uzyskać zatwierdzenie pliku, użyj metody get w zasobie approvals z parametrami ścieżki fileId i approvalId. Jeśli nie znasz identyfikatora zatwierdzenia, możesz wyświetlić listę zatwierdzeń za pomocą metody list.

Treść odpowiedzi zawiera instancję zasobu approvals.

Wyświetlanie listy zatwierdzeń

Aby wyświetlić listę zatwierdzeń pliku, wywołaj metodę list w zasobie approvals i uwzględnij parametr ścieżki fileId.

Treść odpowiedzi zawiera listę zatwierdzeń pliku. Pole items zawiera informacje o każdym zatwierdzeniu w postaci zasobu approvals.

Zasób approvals zawiera też obiekt Status, który zawiera szczegółowe informacje o stanie zatwierdzenia, oraz obiekt ReviewerResponse, który zawiera szczegółowe informacje o odpowiedzi na zatwierdzenie dokonane przez konkretnego weryfikatora. Odpowiedź recenzenta jest reprezentowana przez obiekt Response.

Możesz też przekazywać te parametry zapytania, aby dostosować paginację lub filtrowanie zatwierdzeń:

  • pageSize: maksymalna liczba zatwierdzeń do zwrócenia na stronie. Jeśli nie ustawisz wartości pageSize, serwer zwróci maksymalnie 100 zatwierdzeń.

  • pageToken: token strony otrzymany z poprzedniego wywołania listy. Ten token służy do pobierania kolejnej strony. Powinna być ustawiona na wartość nextPageToken z poprzedniej odpowiedzi.