Tingkat akses yang dikelola cloud

Fitur ini memungkinkan tingkat akses API Anda dikelola oleh organisasi Google Cloud, sehingga memberi Anda manfaat berikut:

• Tidak perlu lagi mengamankan token developer: Akses API dikelola melalui organisasi Google Cloud sehingga Anda tidak perlu lagi mengamankan token developer atau membocorkannya. Anda dapat melewati pengiriman token developer dalam panggilan API, meskipun Anda masih perlu mengirim token akses.

• Mempertahankan project Konsol API Google yang terpisah untuk aplikasi yang berbeda: Setiap project yang ditautkan dalam organisasi Google Cloud akan mewarisi tingkat akses API organisasi. Hal ini memungkinkan Anda membuat beberapa project Konsol API Google di organisasi ini untuk tujuan seperti pengelolaan project terperinci, project terpisah untuk aplikasi yang berbeda, dan beberapa project Konsol API Google untuk anggota tim.

• Pemantauan dan pengelolaan kuota yang lebih baik: Anda dapat memantau penggunaan API untuk setiap project atau membatasi penggunaan API.

Prasyarat

• Token developer yang disetujui

  Anda seharusnya sudah memiliki token developer yang disetujui untuk menggunakan opsi ini. Anda dapat menemukan token developer yang ada di halaman Pusat API di akun pengelola Google Ads Anda. Login, lalu buka ALAT & SETELAN > PENYIAPAN > API Center.

• Organisasi Google Cloud

  Google Ads API mengaitkan token developer Anda ke organisasi Google Cloud dan menggunakannya untuk menentukan level Akses API Anda. Ada beberapa cara untuk membuat organisasi Google Cloud.

  Skenario	Langkah
  Anda sudah menjadi pelanggan Google Workspace atau Google Cloud Identity	Kemungkinan Anda sudah memiliki sumber daya organisasi. Anda dapat Memeriksa dan membuatnya jika perlu.
  Anda tidak menggunakan Google Workspace atau Google Cloud Identity	Daftar ke Google Cloud Identity edisi gratis. Kemudian, buat resource organisasi Anda.
  Tidak satu pun opsi sebelumnya yang sesuai untuk Anda	Jelaskan skenario saat Anda mendaftar uji coba dan minta Google untuk membuat resource organisasi untuk Anda. Google akan memiliki dan mengelola resource organisasi ini tanpa biaya.

• Menyiapkan project Konsol API Google Anda untuk program uji coba

  Anda harus menyiapkan project Konsol API Google yang digunakan dengan Google Ads API untuk program uji coba sebagai berikut:

  Skenario	Langkah
  Anda sudah memiliki organisasi Google Cloud atau membuatnya di langkah sebelumnya	Pastikan semua project Konsol API Google tempat Anda mengaktifkan Google Ads API berada di organisasi ini. Jika tidak, migrasikan resource di bawah organisasi. Jika Anda sudah menjadi pelanggan Google Workspace atau Google Cloud Identity, kemungkinan project Konsol API Google sudah berada di organisasi Anda sehingga Anda dapat melewati langkah ini.
  Anda tidak memiliki organisasi Google Cloud dan tidak dapat membuatnya di langkah sebelumnya	Pastikan Anda adalah pengguna administrator di akun pengelola Google Ads API dan project Konsol API Google Anda. Anda memerlukan izin ini untuk melakukan langkah tambahan setelah permohonan uji coba Anda disetujui.

• Email kontak API terbaru

  Pastikan email kontak Google Ads API Anda adalah yang terbaru. Detail kontak API Anda tercantum di halaman Pusat API di akun pengelola Google Ads API Anda. Login, lalu buka ALAT & SETELAN > PENYIAPAN > API Center.

Daftar ke program uji coba

Daftar untuk program uji coba. Tim Kepatuhan Google kemudian akan meninjau permohonan Anda dan mengirimkan email ke alamat email kontak API Anda yang berisi status persetujuan dan detail tambahan.

Jika Anda meminta Google membuatkan organisasi Google Cloud untuk Anda, ada beberapa langkah tambahan yang diperlukan:

1. Google akan membuat resource organisasi Cloud milik Google untuk Anda. Semua administrator akun pengelola Google Ads API Anda akan diberi peran roles/resourcemanager.projectCreator pada organisasi yang baru dibuat.

2. Google akan mengirimkan email ke alamat email kontak API Anda yang berisi detail resource organisasi yang baru dibuat.

3. Anda harus login ke akun Konsol API Google dan mengikuti petunjuk untuk memindahkan project Konsol API Google di organisasi baru.

4. Balas email untuk memberi tahu Google bahwa project Anda dipindahkan ke organisasi baru.

5. Tim Kepatuhan Google akan meninjau permohonan Anda dan mengirimkan email ke alamat email kontak API Anda yang berisi status persetujuan dan detail tambahan.

Mengubah permintaan API

Anda dapat mengubah aplikasi agar berhenti mengirim header developer-token saat melakukan panggilan API. Ini adalah langkah opsional, tetapi direkomendasikan. Jika Anda berada dalam program uji coba, server Google Ads API akan mengabaikan developer-token jika dikirim sebagai bagian dari permintaan API.

// Create a client.
GoogleAdsClient client = new GoogleAdsClient();

// Opt into the pilot.
client.Config.UseCloudOrgForApiAccess = true;

// Make the API calls.
...

curl -i -X POST https://googleads.googleapis.com/v16/customers/CUSTOMER_ID/googleAds:searchStream \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "login-customer-id: LOGIN_CUSTOMER_ID" \
  --data-binary "@query.json"

Pertanyaan umum (FAQ)

Apakah perubahan ini berarti bahwa saya harus menjadi pelanggan Google Workspace atau Google Cloud agar dapat menggunakan Google Ads API?

Tidak. Anda memerlukan organisasi Google Cloud yang dapat diperoleh dengan banyak cara. Persyaratan ini mirip dengan kebutuhan project Konsol API Google Anda untuk menggunakan Google Ads API saat ini.

Saya perlu mengubah tingkat Akses API saya. Bagaimana cara melakukannya?

Untuk saat ini, Anda harus terus menggunakan Pusat API guna meminta perubahan pada tingkat akses API.

Apakah ada periode nonaktif untuk ikut serta dalam uji coba ini?

Tidak ada. Google Ads API akan otomatis mulai menggunakan tingkat akses API tingkat organisasi setelah disetujui.

Berapa besar upaya yang diperlukan untuk berpartisipasi dalam uji coba ini?

Perubahan kode minimal akan terjadi. Sebagian besar developer dapat menyelesaikan perubahan pada aplikasi dalam waktu kurang dari 30 menit.

Apakah saya akan dikenai biaya jika memilih ikut serta dalam uji coba ini?

Secara umum, tidak, Anda tidak akan dikenai biaya jika memilih ikut serta dalam uji coba ini. Google Ads API ditawarkan tanpa biaya, dan Google tidak melakukan perubahan apa pun pada model penetapan harga Google Ads API.

Skenario yang mungkin dilakukan untuk mendapatkan organisasi Google Cloud adalah sebagai berikut:

1. Anda adalah pelanggan Google Workspace atau Google Cloud Identity:

   Anda akan dikenai biaya seperti biasa untuk penggunaan reguler produk tersebut. Anda tidak akan dikenai biaya untuk membuat organisasi Google Cloud untuk tujuan berpartisipasi dalam uji coba ini.

2. Anda membuat akun Google Cloud Identity edisi gratis:

   Anda tidak akan dikenai biaya saat mendaftar ke akun Google Cloud Identity edisi gratis atau membuat organisasi Google Cloud untuk tujuan berpartisipasi dalam uji coba ini.

3. Google membuat resource organisasi Cloud untuk Anda:

   Ini adalah resource organisasi Cloud internal yang dikelola Google, sehingga Anda tidak akan dikenai biaya.

Saya memiliki beberapa token developer untuk alat yang berbeda. Bagaimana pengaruh uji coba ini terhadap saya?

Kasus penggunaan ini tidak didukung sehingga Anda tidak dapat berpartisipasi dalam uji coba ini.

Apakah hal ini memengaruhi otorisasi API yang sudah ada ke akun yang saya kelola menggunakan Google Ads API?

Tidak, perubahan ini tidak memengaruhi otorisasi API yang ada untuk akun Google Ads yang Anda kelola menggunakan Google Ads API.

Saya memilih ikut serta dalam uji coba ini dan memiliki masalah atau masukan. Bagaimana cara menghubungi dukungan?

Hubungi tim Google Ads API menggunakan halaman dukungan teknis API dan jelaskan jenis masalah Anda. Sertakan detail seperti ID organisasi serta log permintaan dan respons jika memungkinkan.