Panduan memulai menjelaskan cara menyiapkan dan menjalankan aplikasi yang memanggil Google Workspace API. Panduan memulai ini menggunakan pendekatan autentikasi yang disederhanakan yang sesuai untuk lingkungan pengujian. Untuk lingkungan produksi, sebaiknya pelajari
autentikasi dan otorisasi
sebelum
memilih kredensial akses
yang sesuai untuk aplikasi Anda.
Di Apps Script, panduan memulai Google Workspace menggunakan
Layanan Google lanjutan untuk memanggil
Google Workspace API dan menangani beberapa detail autentikasi
dan alur otorisasi.
/** * Lists all labels in the user's mailbox * @see https://developers.google.com/gmail/api/reference/rest/v1/users.labels/list */functionlistLabels(){try{// Gmail.Users.Labels.list() API returns the list of all Labels in user's mailboxconstresponse=Gmail.Users.Labels.list('me');if(!response||response.labels.length===0){// TODO (developer) - No labels are returned from the responseconsole.log('No labels found.');return;}// Print the Labels that are available.console.log('Labels:');for(constlabelofresponse.labels){console.log('- %s',label.name);}}catch(err){// TODO (developer) - Handle exception on Labels.list() APIconsole.log('Labels.list() API failed with error %s',err.toString());}}
Klik Simpan .
Klik Project tanpa judul, ketik
Quickstart, lalu klik Ganti nama.
Mengonfigurasi skrip
Mengaktifkan Gmail API
Buka project Apps Script.
Klik Editorcode.
Di samping Layanan, klik Tambahkan layanan
add .
Pilih
Gmail API
lalu klik Tambahkan.
Menjalankan contoh
Di editor Apps Script, klik Run.
Saat pertama kali dijalankan, contoh aplikasi meminta Anda untuk mengotorisasi akses:
Klik Tinjau izin.
Pilih akun.
Klik Izinkan.
Log eksekusi skrip akan muncul di bagian bawah jendela.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-04 UTC."],[],[],null,["Create a\n[Google Apps Script](/apps-script/overview)\nthat makes requests to the Gmail API.\n\nQuickstarts explain how to set up and run an app that calls a\nGoogle Workspace API. This quickstart uses a\nsimplified authentication approach that is appropriate for a testing\nenvironment. For a production environment, we recommend learning about\n[authentication and authorization](/workspace/guides/auth-overview)\nbefore\n[choosing the access credentials](/workspace/guides/create-credentials#choose_the_access_credential_that_is_right_for_you)\nthat are appropriate for your app.\n\nIn Apps Script, Google Workspace\nquickstarts use\n[Advanced Google services](/apps-script/guides/services/advanced) to call\nGoogle Workspace APIs and handle some details of the authentication\nand authorization flow.\n\nObjectives\n\n- Configure the environment.\n- Create and configure the script.\n- Run the script.\n\nPrerequisites\n\n\u003cbr /\u003e\n\n- A Google account with Gmail enabled.\n\n\u003cbr /\u003e\n\n- Access to Google Drive\n\nCreate the script\n\n1. Create a new script in the Apps Script editor by going to [script.google.com/create](https://script.google.com/create).\n2. Replace the contents of the script editor with the following code:\n\n\ngmail/quickstart/quickstart.gs \n[View on GitHub](https://github.com/googleworkspace/apps-script-samples/blob/main/gmail/quickstart/quickstart.gs) \n\n```javascript\n/**\n * Lists all labels in the user's mailbox\n * @see https://developers.google.com/gmail/api/reference/rest/v1/users.labels/list\n */\nfunction listLabels() {\n try {\n // Gmail.Users.Labels.list() API returns the list of all Labels in user's mailbox\n const response = Gmail.Users.Labels.list('me');\n if (!response || response.labels.length === 0) {\n // TODO (developer) - No labels are returned from the response\n console.log('No labels found.');\n return;\n }\n // Print the Labels that are available.\n console.log('Labels:');\n for (const label of response.labels ) {\n console.log('- %s', label.name);\n }\n } catch (err) {\n // TODO (developer) - Handle exception on Labels.list() API\n console.log('Labels.list() API failed with error %s', err.toString());\n }\n}\n```\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n3. Click Save .\n4. Click **Untitled project** , type **Quickstart** , and click **Rename**.\n\n\u003cbr /\u003e\n\nConfigure the script\n\nEnable the Gmail API\n\nOpen the Apps Script project.\n\n1. Click **Editor** code.\n2. Next to **Services** , click Add a service add .\n3. Select Gmail API and click **Add**.\n\nRun the sample\n\nIn the Apps Script editor, click **Run**.\n\nThe first time you run the sample, it prompts you to authorize access:\n\n1. Click **Review permissions**.\n2. Choose an account.\n3. Click **Allow**.\n\nThe script's execution log appears at the bottom of the window. \ndone It worked! **Great!** Check out the further reading section below to learn more.\nwarning There was a problem **Bummer** , [let us know what went wrong](#). Check out our [troubleshooting](#troubleshooting) section below for some common errors and solutions. If you have found a bug in the code, [report the issue on GitHub](https://github.com/googleworkspace/apps-script-samples/issues) or submit a pull request.\n\nNext steps\n\n- [Google Apps Script Advanced Services documentation](/apps-script/guides/services/advanced)\n- [Try the Google Workspace APIs in the APIs explorer](/workspace/explore)\n- [Troubleshoot authentication and authorization issues](/workspace/gmail/api/troubleshoot-authentication-authorization)\n- [Gmail API reference documentation](/workspace/gmail/api/reference/rest)"]]