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.

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.

Enable the Cloud Translation API.

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, 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.

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

Jika Anda menggunakan Maven, tambahkan kode berikut ke file pom.xml Anda: Untuk informasi lebih lanjut tentang BOM, lihat BOM Library Google Cloud Platform.

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

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

Jika menggunakan Gradle, tambahkan kode berikut ke dependensi Anda:

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

Jika Anda menggunakan sbt, tambahkan kode berikut ke dependensi Anda:

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

Jika menggunakan Visual Studio Code, IntelliJ, atau Eclipse, Anda dapat menambahkan library klien ke project menggunakan plugin IDE berikut:

Plugin menyediakan fungsi tambahan, seperti pengelolaan kunci untuk akun layanan. Lihat dokumentasi setiap plugin untuk mengetahui detailnya.

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

Jika Anda menggunakan Maven, tambahkan kode berikut ke file pom.xml Anda: Untuk informasi lebih lanjut tentang BOM, lihat BOM Library Google Cloud Platform.

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

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

Jika menggunakan Gradle, tambahkan kode berikut ke dependensi Anda:

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

Jika Anda menggunakan sbt, tambahkan kode berikut ke dependensi Anda:

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

Jika menggunakan Visual Studio Code, IntelliJ, atau Eclipse, Anda dapat menambahkan library klien ke project menggunakan plugin IDE berikut:

Plugin menyediakan fungsi tambahan, seperti pengelolaan kunci untuk akun layanan. Lihat dokumentasi setiap plugin untuk mengetahui detailnya.

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.

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 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