Anda sedang melihat dokumentasi lama untuk Google Photos Library API.
Mulai menggunakan REST
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Untuk mulai menggunakan Google Photos Library API, konfigurasi project Anda dengan mengaktifkan API tersebut melalui
Konsol API Google dan menyiapkan
ID klien OAuth 2.0.
Aplikasi Anda berinteraksi dengan Google Foto atas nama
pengguna Google Foto. Misalnya, saat Anda membuat album di
Galeri Google Foto atau upload item media ke galeri foto pengguna
akun Google Foto, pengguna mengizinkan permintaan API ini melalui
OAuth 2.0.
Client ID OAuth 2.0 memungkinkan pengguna aplikasi Anda untuk login, mengautentikasi,
sehingga menggunakan Library API. Library API tidak mendukung
akun layanan; untuk menggunakan API ini, pengguna harus login ke
menggunakan Akun Layanan Anda.
Mengaktifkan API
Sebelum dapat menggunakan Library API, Anda harus mengaktifkannya untuk project Anda.
- Buka Konsol Google API.
- Dari panel menu, pilih project atau buat project baru.
- Untuk membuka Google API Library, dari Navigation menu, pilih
API & Layanan > Library.
- Telusuri "Google Photos Library API". Pilih hasil yang benar, lalu klik
Aktifkan.
Meminta client ID OAuth 2.0
Ikuti langkah-langkah di bawah ini untuk meminta client ID OAuth dan mengonfigurasinya untuk
aplikasi. Contoh ini menggunakan aplikasi yang seluruh alur OAuth
yang ditangani sisi server, seperti
yang ada dalam contoh kami. Proses penyiapan dapat bervariasi
untuk skenario penerapan lainnya.
- Buka Konsol API Google
lalu pilih project Anda.
- Dari menu, pilih API & Layanan > Kredensial.
- Di halaman Credentials, klik Create Credentials > Client ID OAuth yang baru.
- Pilih Application type Anda. Dalam contoh ini, jenis aplikasinya adalah
Aplikasi web.
Mendaftarkan origin tempat aplikasi Anda diizinkan untuk mengakses Google API
sebagai berikut:
- Untuk mengidentifikasi client ID, masukkan nama.
Di kolom Asal JavaScript yang sah, masukkan origin untuk
. Kolom ini tidak mengizinkan karakter pengganti.
Anda dapat memasukkan beberapa origin untuk memungkinkan aplikasi berjalan di berbagai
protokol, domain, atau subdomain. URL yang Anda masukkan diizinkan untuk
memulai permintaan OAuth.
Contoh berikut menunjukkan URL pengembangan lokal (contoh kami menggunakan
localhost:8080) dan URL produksi.
http://localhost:8080
https://myproductionurl.example.com
Kolom Authorized redirect URI adalah endpoint yang menerima
respons dari server OAuth 2.0. Biasanya, hal ini mencakup
pengembangan aplikasi dan menunjuk ke jalur dalam aplikasi Anda.
http://localhost:8080/auth/google/callback
https://myproductionurl.example.com/auth/google/callback
Klik Buat.
-
Dari dialog klien OAuth yang dihasilkan, salin hal berikut:
Aplikasi Anda dapat mengakses Google API yang diaktifkan menggunakan nilai ini.
Sebelum Anda dapat meluncurkan aplikasi publik yang mengakses Library API,
aplikasi Anda harus ditinjau oleh Google. "Aplikasi belum terverifikasi" muncul pada
saat Anda menguji aplikasi, hingga
terverifikasi.
Mencoba sampel
Setelah mengonfigurasi project untuk digunakan dengan Library API,
lihat aplikasi contoh di GitHub. Aplikasi contoh
menunjukkan cara membuat bingkai foto cerdas menggunakan Library API.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-29 UTC.
[null,null,["Terakhir diperbarui pada 2025-08-29 UTC."],[[["\u003cp\u003eTo use the Google Photos Library API, you must enable the API and set up an OAuth 2.0 client ID through the Google API Console.\u003c/p\u003e\n"],["\u003cp\u003eUsers must be signed in to a valid Google Account to use the Library API as it requires user authorization via OAuth 2.0 for actions like creating albums or uploading media.\u003c/p\u003e\n"],["\u003cp\u003eBefore launching publicly, your application needs to be reviewed and verified by Google to remove the "Unverified app" message during testing.\u003c/p\u003e\n"]]],["To utilize the Google Photos Library API, first enable it for your project in the Google API Console. Then, create an OAuth 2.0 client ID, specifying the application type, authorized JavaScript origins, and redirect URIs. Obtain the client ID and secret from the resulting dialog. Ensure your application is reviewed by Google before public launch. Note, only valid Google Account users can use this API as service accounts aren't supported.\n"],null,["# Get started with REST\n\nTo start using the Google Photos Library API, configure your project by enabling the API via\nthe Google API Console and setting up an OAuth 2.0 client ID.\n\nYour application interacts with Google Photos on behalf of a\nGoogle Photos user. For instance, when you create albums in a user's\nGoogle Photos library or upload media items to a user's\nGoogle Photos account, the user authorizes these API requests via the\n[OAuth 2.0](/identity/protocols/OAuth2) protocol.\n\nThe OAuth 2.0 client ID allows your application users to sign in, authenticate,\nand thereby use the Library API. The Library API does not support\nservice accounts; to use this API, users must be signed in to a valid Google\nAccount.\n\nConfigure your app\n------------------\n\n### Enable the API\n\nBefore you can use the Library API, you must enable it for your project.\n\n1. Go to the [Google API Console](https://console.developers.google.com/apis/library).\n2. From the menu bar, select a project or create a new project.\n3. To open the Google API Library, from the Navigation menu, select **APIs \\& Services \\\u003e Library**.\n4. Search for \"Google Photos Library API\". Select the correct result and click **Enable**.\n\n### Request an OAuth 2.0 client ID\n\nFollow the steps below to request an OAuth client ID and configure it for your\napplication. This example uses an application where the entire OAuth flow is\nhandled server-side, such as the one in our samples. The setup process may vary\nfor other [implementation scenarios](/identity/protocols/OAuth2).\n\n1. Go to the [Google API Console](https://console.developers.google.com/apis/library) and select your project.\n2. From the menu, select **APIs \\& Services \\\u003e Credentials**.\n3. On the **Credentials** page, click **Create Credentials \\\u003e OAuth client ID**.\n4. Select your **Application type** . In this example, the application type is **Web application**.\n5. Register the origins from which your app is allowed to access the Google APIs\n as follows:\n\n 1. To identify the client ID, enter a name.\n 2. In the **Authorized JavaScript origins** field, enter the origin for your\n app. This field doesn't allow wildcards.\n\n You can enter multiple origins to allow your app to run on different\n protocols, domains, or subdomains. The URLs you enter are allowed to\n start an OAuth request.\n\n The following example shows a local development URL (our samples use\n `localhost:8080`) and a production URL. \n\n http://localhost:8080\n https://myproductionurl.example.com\n\n 3. The **Authorized redirect URI** field is the endpoint that receives\n responses from the OAuth 2.0 server. Typically, this includes your\n development environment and points to a path in your application.\n\n http://localhost:8080/auth/google/callback\n https://myproductionurl.example.com/auth/google/callback\n\n 4. Click **Create**.\n\n\u003c!-- --\u003e\n\n6. From the resulting OAuth client dialog, copy the following:\n\n - Client ID\n - Client secret\n\n Your app can access the enabled Google APIs using these values.\n\nBefore you can launch a public application that accesses the Library API,\nyour app must be reviewed by Google. An \"Unverified app\" message appears on the\nscreen when you test your application, until it is\n[verified](https://support.google.com/cloud/answer/7454865).\n\nTry out the sample\n------------------\n\nNow that you've configured your project for use with the Library API,\ncheck out the [sample app](/photos/library/samples) on GitHub. The sample app\ndemonstrates how you can build a smart photo frame using the Library API."]]
