Penyiapan

Untuk mulai menggunakan Cloud Translation, Anda memerlukan project yang telah mengaktifkan Cloud Translation API dan kredensial untuk melakukan panggilan yang terautentikasi. Bagian berikut menjelaskan cara melakukan penyiapan sebelum melakukan panggilan pertama ke Cloud Translation API.

Proses penyiapan melibatkan konsol Google Cloud , yang merupakan antarmuka web yang dapat Anda gunakan untuk menyediakan, mengonfigurasi, mengelola, dan memantau sistem di Google Cloud. Jika Anda belum pernah menggunakan konsol Google Cloud sebelumnya, baca halaman Konsol Cloud untuk informasi selengkapnya.

Sebelum memulai

Cloud Translation tersedia dalam dua edisi (Basic dan Advanced). Tentukan edisi yang akan digunakan karena setiap edisi memiliki kumpulan library kliennya sendiri.

Buat atau pilih project

Untuk menggunakan layanan yang disediakan oleh Google Cloud, Anda harus membuat sebuah project. Sebuah project akan mengorganisasikan semua resource Google Cloud Anda. Sebuah project terdiri dari sekumpulan kolaborator, API yang diaktifkan (dan resource lainnya), alat pemantauan, informasi penagihan, serta kontrol akses dan autentikasi. Anda dapat membuat satu project, atau membuat beberapa project dan menggunakannya untuk mengorganisasikan resource Google Cloud dalam hierarki resource. Saat membuat project, catat project ID. ID ini dibutuhkan untuk membuat panggilan API. Untuk mengetahui informasi selengkapnya tentang project, baca dokumentasi Resource Manager.

Sebaiknya Anda membuat project terpisah untuk eksperimen, pengujian, dan produksi. Setelah Anda membuat sebuah project, catat nomor atau ID projectnya. Anda harus memberikan nomor (atau ID) project saat melakukan panggilan ke Cloud Translation API.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Mengaktifkan penagihan

Anda harus mengaktifkan penagihan untuk menggunakan Cloud Translation. Untuk mengetahui informasi selengkapnya tentang harga Cloud Translation, baca halaman harga.

Catatan: Untuk membantu mengelola anggaran, Anda dapat menetapkan batas penggunaan pada project. Untuk informasi selengkapnya, baca Menetapkan kuota penggunaan.

Akun penagihan digunakan untuk menentukan siapa yang membayar serangkaian resource tertentu, dan dapat ditautkan ke satu atau beberapa project. Penggunaan project ditagihkan ke akun penagihan tertaut. Dalam sebagian besar kasus, Anda mengonfigurasi penagihan saat membuat project. Untuk mengetahui informasi selengkapnya, baca dokumentasi Penagihan.

Verify that billing is enabled for your Google Cloud project.

Mengaktifkan API

Anda harus mengaktifkan Cloud Translation API untuk project. Untuk mengetahui informasi selengkapnya tentang cara mengaktifkan API, baca dokumentasi Penggunaan Layanan.

Enable the Cloud Translation API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Menetapkan kuota penggunaan

Cloud Translation memiliki sistem pengelolaan kuota untuk membantu Anda dan Google mengelola penggunaan layanan. Secara default, jumlah karakter yang dapat Anda kirim per hari tidak terbatas. Jika Anda memiliki anggaran yang ditetapkan, sebaiknya pantau penggunaan harian dan sesuaikan kuota sesuai dengan rencana pengeluaran Anda.

Untuk mengetahui informasi selengkapnya tentang kuota, baca Kuota dan batas.

Menyiapkan autentikasi

Jika berencana menggunakan Cloud Translation API, Anda perlu menyiapkan autentikasi. Setiap aplikasi klien yang menggunakan API harus diautentikasi dan diberi akses ke resource yang diminta. Untuk mengetahui informasi selengkapnya, baca Mengautentikasi ke Cloud Translation.

Peran Identity and Access Management

Saat principal (akun pengguna, akun layanan, dan sebagainya) memanggil API,Google Cloud mewajibkan principal memiliki izin yang sesuai. Anda dapat memberikan izin dengan memberikan peran ke principal. Untuk mengetahui informasi selengkapnya, baca Mengontrol akses dengan IAM.

Catatan: Izin peran hanya berlaku untuk Cloud Translation - Advanced. Meskipun dapat menggunakan akun layanan untuk kedua edisi, Anda hanya dapat menetapkan izin tertentu untuk Cloud Translation - Advanced. Untuk Cloud Translation - Basic, Anda dapat membuat permintaan apa pun terlepas dari izin akun layanan.

Menginstal library klien

Library klien tersedia untuk beberapa bahasa populer. Sebaiknya gunakan library klien ini untuk melakukan panggilan ke Cloud Translation karena library tersebut memudahkan akses ke API. Jika library klien tidak memenuhi kebutuhan Anda atau tidak tersedia untuk bahasa Anda, buat kode kustom sendiri. Untuk mengetahui informasi selengkapnya, baca Menggunakan kode klien Anda sendiri.

Misalnya, saat Anda menggunakan library klien, library tersebut dapat menentukan kredensial Anda secara implisit melalui variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS. Anda tidak perlu menentukan kredensial Anda secara eksplisit dalam kode. Untuk mengetahui informasi selengkapnya, baca Penjelasan Library Klien dalam dokumentasi Cloud API.

Library klien Cloud Translation - Basic

Pilih bahasa pemrograman yang Anda gunakan untuk pengembangan, lalu jalankan perintah terkait. Untuk mengetahui informasi selengkapnya, baca ringkasan library klien Cloud Translation - Basic.

C#

nuget install Google.Cloud.Translation.V2

Go

go get cloud.google.com/go/translate

Java

Perhatian: Library klien Java tidak mendukung Android.

If you are using Maven, add the following to your pom.xml file. For more information about BOMs, see The Google Cloud Platform Libraries BOM.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.71.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-translate</artifactId>
  </dependency>
</dependencies>

If you are using Gradle, add the following to your dependencies:

implementation 'com.google.cloud:google-cloud-translate:2.78.0'

If you are using sbt, add the following to your dependencies:

libraryDependencies += "com.google.cloud" % "google-cloud-translate" % "2.78.0"

If you're using Visual Studio Code or IntelliJ, you can add client libraries to your project using the following IDE plugins:

• Cloud Code for VS Code
• Cloud Code for IntelliJ

The plugins provide additional functionality, such as key management for service accounts. Refer to each plugin's documentation for details.

Note: Cloud Java client libraries do not currently support Android.

Node.js

Untuk mengetahui informasi selengkapnya tentang cara menyiapkan lingkungan pengembangan Node.js, baca Panduan Penyiapan Lingkungan Pengembangan Node.js.

npm install @google-cloud/translate

PHP

composer require google/cloud-translate

Python

Untuk mengetahui informasi selengkapnya tentang cara menyiapkan lingkungan pengembangan Python, baca Panduan Penyiapan Lingkungan Pengembangan Python.

pip install google-cloud-translate==2.0.1

Ruby

Untuk mengetahui informasi selengkapnya tentang cara menyiapkan lingkungan pengembangan Ruby, baca Panduan Penyiapan Lingkungan Pengembangan Ruby.

gem install google-cloud-translate-v2

Library klien Cloud Translation - Advanced

Pilih bahasa pemrograman yang Anda gunakan untuk pengembangan, lalu jalankan perintah terkait. Untuk informasi selengkapnya, baca ringkasan library klien Cloud Translation - Advanced.

C#

nuget install Google.Cloud.Translate.V3 -Pre

Go

go get cloud.google.com/go/translate/apiv3

Java

Perhatian: Library klien Java tidak mendukung Android.

If you are using Maven, add the following to your pom.xml file. For more information about BOMs, see The Google Cloud Platform Libraries BOM.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.71.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-translate</artifactId>
  </dependency>
</dependencies>

If you are using Gradle, add the following to your dependencies:

implementation 'com.google.cloud:google-cloud-translate:2.78.0'

If you are using sbt, add the following to your dependencies:

libraryDependencies += "com.google.cloud" % "google-cloud-translate" % "2.78.0"

If you're using Visual Studio Code or IntelliJ, you can add client libraries to your project using the following IDE plugins:

• Cloud Code for VS Code
• Cloud Code for IntelliJ

The plugins provide additional functionality, such as key management for service accounts. Refer to each plugin's documentation for details.

Note: Cloud Java client libraries do not currently support Android.

Node.js

Untuk mengetahui informasi selengkapnya tentang cara menyiapkan lingkungan pengembangan Node.js, baca Panduan Penyiapan Lingkungan Pengembangan Node.js.

npm install @google-cloud/translate

PHP

composer require google/cloud-translate

Python

Untuk mengetahui informasi selengkapnya tentang cara menyiapkan lingkungan pengembangan Python, baca Panduan Penyiapan Lingkungan Pengembangan Python.

pip install --upgrade google-cloud-translate

Ruby

Untuk mengetahui informasi selengkapnya tentang cara menyiapkan lingkungan pengembangan Ruby, baca Panduan Penyiapan Lingkungan Pengembangan Ruby.

gem install google-cloud-translate

Menginstal Google Cloud CLI

Catatan: Langkah ini dapat dilewati jika Anda tidak akan menggunakan command line untuk melakukan panggilan API yang diautentikasi.

Jika Anda berencana untuk mengirim permintaan Cloud Translation melalui command line (misalnya melalui perintah curl), instal dan inisialisasi gcloud CLI, yang disertakan dalam Google Cloud CLI. Link berikut memberikan informasi selengkapnya:

Instal Google Cloud CLI. Setelah penginstalan, inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:

gcloud init

Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

Menguji SDK dan autentikasi

Jika telah menyiapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS, Anda dapat menggunakan gcloud untuk menguji lingkungan autentikasi. Jalankan perintah berikut dan pastikan tidak ada error yang terjadi dan kredensial ditampilkan:

gcloud auth application-default print-access-token

Perintah sebelumnya digunakan oleh semua sampel REST command line Cloud Translation untuk mengautentikasi panggilan API.

Langkah berikutnya

• Coba panduan memulai untuk melakukan panggilan terjemahan sederhana:

  • Panduan memulai Cloud Translation - Basic
  • Panduan memulai Cloud Translation - Advanced

• Lihat ringkasan produk untuk mengetahui informasi selengkapnya tentang cara menggunakan berbagai fitur Cloud Translation.

Coba sendiri

Jika Anda baru pertama kali menggunakan Google Cloud, buat akun untuk mengevaluasi performa Cloud Translation dalam skenario dunia nyata. Pelanggan baru juga akan mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

Coba Cloud Translation secara gratis