Jak korzystać z API Google Drive i uzyskać klucz API

Czym jest Google Drive API

Google Drive API to narzędzie, które umożliwia tworzenie aplikacji wykorzystujących przechowywanie danych w chmurze Google Drive. Dzięki tej funkcji możesz tworzyć aplikacje integrujące z Google Drive i dodawać potężne możliwości w Twoich aplikacjach.

Co możesz zrobić, korzystając z tego narzędzia

Ta opcja może być używana do:

• Pobieraj i przesyłaj pliki do Drive.
• Wyszukuj pliki i foldery.
• Twórz zaawansowane zapytania wyszukiwania, które zwracają dowolne pola metadanych plików z zasobu Files.
• Pozwól użytkownikom udostępniać pliki, foldery i dyski, aby współpracować nad treścią.
• Połącz z API Picker, aby przeszukać wszystkie pliki w Google Drive i zwrócić nazwę pliku, URL, datę ostatniej modyfikacji oraz użytkownika.
• Utwórz skróty, które są zewnętrznymi odnośnikami do danych przechowywanych poza Dyskiem Google, w innym magazynie danych lub systemie przechowywania w chmurze.
• Utwórz dedykowany folder na dane swojej aplikacji, aby zapobiec dostępowi aplikacji do całej zawartości użytkownika.
• Zintegruj się z interfejsem Drive UI, który umożliwia interakcję z plikami Drive.

Aby skutecznie pracować z API, musisz uzyskać klucz API. Zobaczmy, jak to zrobić.

Jak uzyskać klucz API Google Drive

Aby wygenerować klucz API, Twoje konto musi mieć podstawową rolę Edytora w bieżącym projekcie. 

Aby skonfigurować klucz API, wykonaj następujące kroki:

• Otwórz API i usługi → panel Poświadczeń w konsoli Google Drive API w chmurze.

• Wybierz opcję Utwórz dane uwierzytelniające, a następnie wybierz klucz API z listy rozwijanej.

• Ekran dialogowy zaprezentuje Twój nowy klucz API.

Jeśli chcesz określić, które strony internetowe, adresy IP lub aplikacje mogą korzystać z Twojego klucza API, możesz dodać ograniczenia aplikacyjne na podstawie typu aplikacji. Pamiętaj, że dla jednego klucza API możesz ustawić tylko jeden typ ograniczeń.

Oto przykład uzyskiwania uprawnień przy użyciu biblioteki klienckiej.

Aby skonfigurować klucz API, wykonaj następujące kroki:

operator określa warunek dla terminu zapytania. Zobacz Operatory zapytań, aby zobaczyć, jakich operatorów możesz użyć z każdym terminem zapytania.

Jak mogę zacząć korzystać z Drive API?

Przy tworzeniu uprawnienia wymagane są następujące pola:

Pozwól użytkownikom udostępniać pliki, foldery i dyski, aby współpracować nad treścią.

Poniższy przykład pokazuje, jak zainicjować sesję wznowioną w celu przesłania nowego pliku:

Przykład 5: Usuwanie pliku z Drive API

Przykład 3: Wyszukiwanie plików w Google Drive API i wyświetlanie plików w folderze

4. Dokumentacja Google Drive API

Otwórz API i usługi → panel Poświadczeń w konsoli Google Drive API w chmurze.

7. Zakończenie

Google Drive API to narzędzie, które umożliwia tworzenie aplikacji wykorzystujących przechowywanie danych w chmurze Google Drive. Dzięki tej funkcji możesz tworzyć aplikacje integrujące z Google Drive i dodawać potężne możliwości w Twoich aplikacjach.

Przesyłanie wieloczęściowe. Można go użyć do szybkiego transferu niewielkiego pliku oraz metadanych opisujących plik — wszystko w jednym żądaniu.

Wskazówka: Role służą do przydzielania uprawnień użytkownikowi, grupie lub kontu serwisowemu do korzystania z zasobu. Więcej informacji o rolach znajdziesz tutaj.

Powiedz nam teraz: czy korzystasz z tego narzędzia? Czy kiedykolwiek napotkałeś trudności podczas pracy z nim? Podziel się swoimi uwagami w komentarzach! Nie zapomnij też wkrótce zajrzeć na naszego bloga, aby uzyskać więcej praktycznych porad.

Korzystanie z Google Drive API jest całkowicie darmowe. Istnieją jednak pewne limity. Tabelę znajdziesz w sekcji Cennik powyżej.

1. Czym jest Google Drive API

Ta opcja może być używana do:

Aby wygenerować klucz API, Twoje konto musi mieć podstawową rolę Edytora w bieżącym projekcie. 

Jak mogę uzyskać pomoc w zakresie Drive API?

Co możesz zrobić, korzystając z tego narzędzia

Przykład 4: API arkusza Drive

Aby utworzyć nowy arkusz kalkulacyjny, użyj metody create() na kolekcji arkuszy, tak jak pokazano w poniższym przykładzie.

Możesz znaleźć link do prośby o większy limit w zakładce Kwoty — jeśli potrzebujesz więcej niż domyślne. Aby uzyskać więcej informacji o cenach, sprawdź tę stronę.

Żądania na dzień

Jeśli chcesz określić, które strony internetowe, adresy IP lub aplikacje mogą korzystać z Twojego klucza API, możesz dodać ograniczenia aplikacyjne na podstawie typu aplikacji. Pamiętaj, że dla jednego klucza API możesz ustawić tylko jeden typ ograniczeń.

Wybierz opcję Utwórz dane uwierzytelniające, a następnie wybierz klucz API z listy rozwijanej.

Poniższy przykład demonstruje proste żądanie wysyłki:

Limity 1,000

Żądanie wieloczęściowego przesyłania może wyglądać następująco:

3. Korzystanie z Google Drive API: przykłady

Dokumentacja Google Drive API

Dowiedz się, czym jest Google Drive API i zobacz przykłady użycia — udostępnianie plików za pomocą Drive API, wyszukiwanie plików w folderze, usuwanie pliku i wiele innych.Dowiedz się, czym jest Google Drive API i zobacz przykłady użycia — udostępnianie plików za pomocą Drive API, wyszukiwanie plików w folderze, usuwanie pliku i wiele innych.

Więcej przykładów dostępnych jest tutaj.

Utwórz skróty, które są zewnętrznymi odnośnikami do danych przechowywanych poza Dyskiem Google, w innym magazynie danych lub systemie przechowywania w chmurze.

Możesz użyć serwisu Stack Overflow (Q&A), aby opublikować swoje pytania techniczne. Programiści zwykle używają tagu [google-drive-api], aby oznaczać pytania związane z tą usługą.

Żądania 5. Limity i ceny Google Drive API

Możesz znaleźć niezbędną dokumentację Google Drive API tutaj. Zawiera ona wszystkie pliki dotyczące pracy z API dla deweloperów oraz integracji API z Twoją stroną internetową.

Aby wyszukać konkretny zestaw plików i folderów, powinieneś użyć ciągu zapytania q z files.list, aby filtrować zwracane pliki.

Rola. Określa operacje, które ten typ może wykonywać.

Przykłady użycia Google Drive API

Przykład 2: Udostępnianie pliku w Google Drive API

Ile kosztuje Google Drive API?

Mam niewystarczające uprawnienia do Google Drive API. Co mam zrobić?

Aby skutecznie pracować z API, musisz uzyskać klucz API. Zobaczmy, jak to zrobić.

Wyszukuj pliki i foldery.

Limity i ceny Google Drive API

POST googleapis/upload/drive/v3/files?uploadType=media HTTP/1.1
Content-Type: image/jpeg
Content-Length: [NUMBER_OF_BYTES_IN_FILE]
Authorization: Bearer [YOUR_AUTH_TOKEN]

[JPEG_DATA]

Przykład 1: Przesyłanie pliku do Google Drive API

Czym jest Google Drive API

String pageToken = null;
do {
  FileList result = driveService.files().list()
      .setQ("mimeType='image/jpeg'")
      .setSpaces("drive")
      .setFields("nextPageToken, files(id, name)")
      .setPageToken(pageToken)
      .execute();
  for (File file : result.getFiles()) {
    System.out.printf("Found file: %s (%s)n",
        file.getName(), file.getId());
  }
  pageToken = result.getNextPageToken();
} while (pageToken != null);

termin zapytania, operator, wartości

values to konkretne wartości, których używasz do filtrowania wyników wyszukiwania.

Utwórz dedykowany folder na dane swojej aplikacji, aby zapobiec dostępowi aplikacji do całej zawartości użytkownika.

Możesz przesłać dane pliku podczas tworzenia lub aktualizacji zasobu pliku. Istnieją trzy typy przesyłek, które możesz wykonać:

Typ. Określa zakres uprawnień – użytkownik, grupa, domena lub każdy.

Pobieraj i przesyłaj pliki do Drive.

Możesz wypróbować opcję Quickstart, aby skonfigurować i uruchomić pierwszą aplikację Google Drive.

Przykład 3: Wyszukiwanie plików w Drive API i wyświetlanie plików w folderze Co możesz zrobić za pomocą tego narzędzia

Jak widać, praca z Drive API nie jest taka trudna. Uzyskanie klucza API zajmie mniej niż trzy minuty, a ten samouczek Drive API będzie przydatny.

Korzystanie z Google Drive API jest całkowicie darmowe dla użytkowników na całym świecie. Chociaż istnieją pewne limity użycia:

query_term to termin zapytania lub pola do wyszukiwania. Aby przeglądać terminy zapytań, które można użyć do filtrowania współdzielonych dysków, zobacz Search query terms.

Przykłady użycia Google Drive API

Istnieje kilka sposobów, w jaki możesz korzystać z Google Drive API. Omówmy niektóre z nich.

Przykład 1: Przesyłanie pliku do Google Drive API

Możesz przesłać dane pliku podczas tworzenia lub aktualizacji zasobu pliku. Istnieją trzy typy przesyłek, które możesz wykonać:

• Proste. Nadaje się do szybkiego przesyłania małych plików (5 MB lub mniej).
• Przesyłanie wieloczęściowe. Można go użyć do szybkiego transferu niewielkiego pliku oraz metadanych opisujących plik — wszystko w jednym żądaniu.
• Przesył z możliwością wznowienia. Umożliwia to bardziej niezawodny transfer, zwłaszcza przy dużych plikach.

Poniższy przykład demonstruje proste żądanie wysyłki:

POST googleapis/upload/drive/v3/files?uploadType=media HTTP/1.1
Content-Type: image/jpeg
Content-Length: [NUMBER_OF_BYTES_IN_FILE]
Authorization: Bearer [YOUR_AUTH_TOKEN]

[JPEG_DATA]

Żądanie wieloczęściowego przesyłania może wyglądać następująco:

POST googleapis/upload/drive/v3/files?uploadType=multipart HTTP/1.1
Authorization: Bearer [YOUR_AUTH_TOKEN]
Content-Type: multipart/related; boundary=foo_bar_baz
Content-Length: [NUMBER_OF_BYTES_IN_ENTIRE_REQUEST_BODY]

--foo_bar_baz
Content-Type: application/json; charset=UTF-8

{
  "name": "myObject"
}

--foo_bar_baz
Content-Type: image/jpeg

[JPEG_DATA]
--foo_bar_baz--

Poniższy przykład pokazuje, jak zainicjować sesję wznowioną w celu przesłania nowego pliku:

POST googleapis/upload/drive/v3/files?uploadType=resumable HTTP/1.1
Authorization: Bearer [YOUR_AUTH_TOKEN]
Content-Length: 38
Content-Type: application/json; charset=UTF-8
X-Upload-Content-Type: image/jpeg
X-Upload-Content-Length: 2000000

{
  "name": "myObject"
}

Większość bibliotek klienckich Google API używa co najmniej jednej z tych metod. Aby uzyskać więcej informacji o tym, jak korzystać z każdej z metod, kliknij tutaj.
 

Przykład 2: Udostępnianie pliku przez Google Drive API

Każdy plik w Google Drive ma powiązane zasoby uprawnień. Każde zasoby identyfikuje uprawnienie dla określonego typu i roli, na przykład „commenter” lub „reader”. Aby udostępnić plik lub folder, użytkownik musi mieć rolę „writer”. 

Przy tworzeniu uprawnienia wymagane są następujące pola:

• Typ. Określa zakres uprawnień – użytkownik, grupa, domena lub każdy.
• Rola. Określa operacje, które ten typ może wykonywać.

Oto przykład uzyskiwania uprawnień przy użyciu biblioteki klienckiej.

String fileId = "1sTWaJ_j7PkjzaBWtNc3IzovK5hQf21FbOw9yLeeLPNQ";
JsonBatchCallback<Permission> <?gt; callback = new JsonBatchCallback<Permission>() {
  @Override
  public void onFailure(GoogleJsonError e,
                        HttpHeaders responseHeaders)
      throws IOException {
    // Handle error
    System.err.println(e.getMessage());
  }

  @Override
  public void onSuccess(Permission permission,
                        HttpHeaders responseHeaders)
      throws IOException {
    System.out.println("ID uprawnienia: " + permission.getId());
  }
};
BatchRequest batch = driveService.batch();
Permission userPermission = new Permission()
    .setType("user")
    .setRole("writer")
    .setEmailAddress("user@example.com");
driveService.permissions().create(fileId, userPermission)
    .setFields("id")
    .queue(batch, callback);

Permission domainPermission = new Permission()
    .setType("domain")
    .setRole("reader")
    .setDomain("example.com");
driveService.permissions().create(fileId, domainPermission)
    .setFields("id")
    .queue(batch, callback);

batch.execute();

tutaj.

Przykład 3: Wyszukiwanie plików w Google Drive API i wyświetlanie plików w folderze

Aby wyszukać konkretny zestaw plików i folderów, powinieneś użyć ciągu zapytania q z files.list, aby filtrować zwracane pliki.

Poniższy przykład ilustruje format ciągu zapytania:

termin zapytania, operator, wartości

Gdzie:

• query_term to termin zapytania lub pola do wyszukiwania. Aby przeglądać terminy zapytań, które można użyć do filtrowania współdzielonych dysków, zobacz Search query terms.
• operator określa warunek dla terminu zapytania. Zobacz Operatory zapytań, aby zobaczyć, jakich operatorów możesz użyć z każdym terminem zapytania.
• values to konkretne wartości, których używasz do filtrowania wyników wyszukiwania.

Poniższy przykład ilustruje, jak użyć biblioteki klienckiej do filtrowania wyników wyszukiwania według nazw plików i identyfikatorów obrazów JPEG.

String pageToken = null;
do {
  FileList result = driveService.files().list()
      .setQ("mimeType='image/jpeg'")
      .setSpaces("drive")
      .setFields("nextPageToken, files(id, name)")
      .setPageToken(pageToken)
      .execute();
  for (File file : result.getFiles()) {
    System.out.printf("Found file: %s (%s)n",
        file.getName(), file.getId());
  }
  pageToken = result.getNextPageToken();
} while (pageToken != null);

Więcej przykładów dostępnych jest tutaj.

Przykład 4: Google Drive API arkuszy kalkulacyjnych

Aby utworzyć nowy arkusz kalkulacyjny, użyj metody create() na kolekcji arkuszy, tak jak pokazano w poniższym przykładzie.

Spreadsheet spreadsheet = new Spreadsheet()
        .setProperties(new SpreadsheetProperties()
                .setTitle(title));
spreadsheet = service.spreadsheets().create(spreadsheet)
        .setFields("spreadsheetId")
        .execute();
System.out.println("ID arkusza kalkulacyjnego: " + spreadsheet.getSpreadsheetId());

Przykład 5: Usuwanie pliku za pomocą Google Drive API

Aby ominąć kosz, możesz trwale usunąć plik po identyfikatorze. Obecnie uwierzytelniony użytkownik musi być właścicielem pliku lub być organizatorem nadrzędnego folderu dla plików na wspólnym dysku. Przykład kodu dla tej metody:

import com.google.api.services.drive.Drive;
 
import java.io.IOException;
// ...
 
public class MyClass {
 
  // ...
 
  /**
   * Permanently delete a file, skipping the trash.
   *
   * @param service Drive API service instance.
   * @param fileId ID of the file to delete.
   */
  private static void deleteFile(Drive service, String fileId) {
    try {
      service.files().delete(fileId).execute();
    } catch (IOException e) {
      System.out.println("Wystąpił błąd: " + e);
    }
  }
 
  // ...
 
}

Dokumentacja Google Drive API

Możesz znaleźć niezbędną dokumentację Google Drive API tutaj. Zawiera ona wszystkie pliki dotyczące pracy z API dla deweloperów oraz integracji API z Twoją stroną internetową.

Limity i ceny Google Drive API

Korzystanie z Google Drive API jest całkowicie darmowe dla użytkowników na całym świecie. Chociaż istnieją pewne limity użycia:

Żądania	Limity
Żądania na dzień	1 000 000
Żądania na 100 sekund na użytkownika	1,000

Możesz znaleźć link do prośby o większy limit w zakładce Kwoty — jeśli potrzebujesz więcej niż domyślne. Aby uzyskać więcej informacji o cenach, sprawdź tę stronę.

FAQ (często zadawane pytania)

Podsumowanie

Jak widać, praca z Drive API nie jest taka trudna. Uzyskanie klucza API zajmie mniej niż trzy minuty, a ten samouczek Drive API będzie przydatny.

Powiedz nam teraz: czy korzystasz z tego narzędzia? Czy kiedykolwiek napotkałeś trudności podczas pracy z nim? Podziel się swoimi uwagami w komentarzach! Nie zapomnij też wkrótce zajrzeć na naszego bloga, aby uzyskać więcej praktycznych porad.