Tingkat akses yang dikelola cloud

Catatan: Google menerima pelamar untuk program ini. Daftar.

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

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

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

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

Prasyarat

• Token developer yang disetujui

  Anda harus sudah memiliki token developer yang disetujui untuk menggunakan opsi ini. Anda dapat menemukan token developer yang ada di Pusat API di akun pengelola Google Ads. Login, lalu buka Admin > Pusat API. Di Pusat API, buka Akses API > Token developer.

• Organisasi Google Cloud

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

  Skenario	Langkah
  Anda adalah pelanggan Google Workspace atau Google Cloud Identity	Kemungkinan besar Anda sudah memiliki resource organisasi. Anda dapat Memeriksa dan membuat satu jika diperlukan.
  Anda tidak menggunakan Google Workspace atau Google Cloud Identity	Daftar ke edisi gratis dari Google Cloud Identity. Kemudian buat resource organisasi Anda.
  Tidak ada opsi sebelumnya yang sesuai untuk Anda	Jelaskan skenario Anda saat mendaftar ke program uji coba dan meminta Google membuat resource organisasi untuk Anda. Google akan memiliki dan mengelola resource organisasi ini tanpa biaya.

• Siapkan project Konsol API Google untuk program uji coba

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

  Skenario	Langkah
  Anda sudah memiliki organisasi Google Cloud atau membuatnya pada langkah langkah sebelumnya	Pastikan semua project Konsol API Google tempat Anda mengaktifkan Google Ads API berada di bawah organisasi ini. Jika tidak, migrasikan project tersebut ke organisasi. Jika Anda adalah pelanggan Google Workspace atau Google Cloud Identity, kemungkinan besar project Konsol API Google sudah berada di bawah 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 memerlukan izin ini untuk melakukan langkah tambahan setelah aplikasi program uji coba Anda disetujui.

• Email kontak API yang terbaru

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

Mendaftar ke program uji coba

Daftar ke program uji coba. Tim Kepatuhan Google akan meninjau aplikasi Anda dan mengirim email ke alamat email kontak API Anda yang berisi status persetujuan dan detail tambahan.

Jika Anda meminta Google membuat organisasi Google Cloud untuk Anda, ada beberapa langkah tambahan yang perlu dilakukan:

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 di organisasi yang baru dibuat.

2. Google akan mengirim 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 Anda ke organisasi baru.

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

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

Mengubah permintaan API

Anda dapat mengubah aplikasi untuk berhenti mengirim header developer-token saat melakukan panggilan API. Langkah ini bersifat 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.

Java

Segera hadir!

.NET

Download dan instal Google Ads API.NET library versi 17.1 .0 atau yang lebih baru.

Selanjutnya, ubah kode Anda sebagai berikut:

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

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

// Make the API calls.
...

PHP

Segera hadir!

Python

Segera hadir!

Ruby

Segera hadir!

Perl

Segera hadir!

Klien HTTP (REST)

Hapus header developer-token dalam permintaan HTTP Anda:

curl -i -X POST https://googleads.googleapis.com/v24/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)

Berikut beberapa pertanyaan umum (FAQ) tentang level akses yang dikelola Cloud.

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

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

Saya perlu mengubah level Akses API. Bagaimana cara melakukannya?

Untuk saat ini, Anda harus terus menggunakan Pusat API untuk meminta perubahan pada level akses API.

Apakah ada waktu nonaktif untuk ikut serta dalam program uji coba ini?

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

Berapa banyak upaya yang diperlukan untuk berpartisipasi dalam program uji coba ini?

Anda hanya perlu melakukan perubahan kode minimal. Sebagian besar developer dapat menyelesaikan perubahan pada aplikasi mereka dalam waktu kurang dari 30 menit.

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

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

Berikut adalah kemungkinan skenario untuk mendapatkan organisasi Google Cloud:

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 dengan tujuan berpartisipasi dalam program uji coba ini.

2. Anda membuat akun edisi gratis Google Cloud Identity:

   Anda tidak akan dikenai biaya saat mendaftar ke akun edisi gratis Google Cloud Identity atau saat membuat organisasi Google Cloud dengan tujuan berpartisipasi dalam program 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 program uji coba ini terhadap saya?

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

Apakah hal ini memengaruhi otorisasi API yang ada untuk 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 ikut serta dalam program uji coba ini dan memiliki masalah atau masukan. Bagaimana cara menghubungi dukungan?

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