Penyiapan

Untuk mulai menggunakan Cloud Translation, Anda memerlukan project yang telah mengaktifkan Cloud Translation API dan kredensial untuk melakukan panggilan yang diautentikasi. 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 Google Cloud Console, lihat halaman Cloud Console untuk mengetahui 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 project. Project menyusun 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 mengatur resource Google Cloud dalam hierarki resource. Saat membuat project, catat ID project. ID ini dibutuhkan untuk membuat panggilan API. Untuk mengetahui informasi selengkapnya tentang project, lihat dokumentasi Resource Manager.

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

Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

Buka pemilih project

Aktifkan penagihan

Anda harus mengaktifkan penagihan untuk menggunakan Cloud Translation. Untuk mengetahui informasi lebih lanjut tentang harga Cloud Translation, lihat halaman harga.

Catatan: Untuk membantu mengelola anggaran, Anda dapat menetapkan batas penggunaan pada project. Untuk mengetahui informasi selengkapnya, lihat 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, lihat dokumentasi Penagihan.

Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

Mengaktifkan API

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

Aktifkan Cloud Translation API.

Mengaktifkan 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, lihat 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, lihat Mengautentikasi ke Cloud Translation.

Peran Identity and Access Management

Saat akun utama (akun pengguna, akun layanan, dan sebagainya) memanggil API, Google Cloud mewajibkan akun utama memiliki izin yang sesuai. Anda dapat memberikan izin dengan memberikan peran ke akun utama. Untuk mengetahui informasi selengkapnya, lihat 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, lihat 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 informasi selengkapnya, lihat Penjelasan Library Klien dalam dokumentasi Cloud API.

Cloud Translation - Library klien tingkat dasar

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

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.44.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

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

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

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

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

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

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

• Cloud Code for VS Code
• Cloud Code for IntelliJ
• Cloud Tools for Eclipse

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 lebih lanjut tentang cara menyiapkan lingkungan pengembangan Node.js, lihat Panduan Penyiapan Lingkungan Pengembangan Node.js.

npm install --save @google-cloud/translate

PHP

composer require google/cloud-translate

Python

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

pip install google-cloud-translate==2.0.1

Ruby

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

gem install google-cloud-translate-v2

Cloud Translation - Library klien tingkat lanjut

Pilih bahasa pemrograman yang Anda gunakan untuk pengembangan, lalu jalankan perintah terkait. Untuk informasi selengkapnya, lihat Cloud Translation - Ringkasan library klien lanjutan.

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.44.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

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

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

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

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

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

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

• Cloud Code for VS Code
• Cloud Code for IntelliJ
• Cloud Tools for Eclipse

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 lebih lanjut tentang cara menyiapkan lingkungan pengembangan Node.js, lihat Panduan Penyiapan Lingkungan Pengembangan Node.js.

npm install --save @google-cloud/translate

PHP

composer require google/cloud-translate

Python

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

pip install --upgrade google-cloud-translate

Ruby

Untuk mengetahui informasi selengkapnya tentang cara menyiapkan lingkungan pengembangan Ruby, lihat 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, lalu initialize dengan menjalankan perintah berikut:

gcloud init

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 contoh REST command line Cloud Translation untuk mengautentikasi panggilan API.

Langkah berikutnya

• Coba panduan memulai untuk melakukan panggilan terjemahan yang mudah:

  • Cloud Translation - Panduan memulai Dasar
  • Cloud Translation - Panduan memulai lanjutan

• Lihat panduan cara kerja untuk mendapatkan informasi lebih lanjut mengenai cara menggunakan berbagai fitur Cloud Translation.

Coba sendiri

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

Coba Cloud Translation secara gratis