Tingkat akses yang dikelola cloud

Catatan: Google menerima pelamar untuk program ini. Daftar.

Fitur ini memungkinkan tingkat 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 tentang mengamankan token developer atau kebocoran token. Anda dapat melewati pengiriman token developer dalam panggilan API, meskipun Anda tetap perlu mengirim token akses.

• Pertahankan project Konsol API Google yang terpisah untuk aplikasi yang berbeda: Setiap project yang ditautkan dalam organisasi Google Cloud mewarisi tingkat akses API organisasi. Dengan begitu, Anda dapat membuat beberapa project Konsol API Google dalam organisasi ini untuk tujuan seperti pengelolaan project yang 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 Anda. 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 tingkat Akses API Anda. Ada beberapa cara untuk membuat organisasi Google Cloud.

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

• Menyiapkan project Konsol API Google untuk program uji coba

  Anda harus menyiapkan project Konsol Google API yang Anda gunakan 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 ke organisasi. Jika Anda adalah pelanggan Google Workspace atau Google Cloud Identity, kemungkinan 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 Google API Console. Anda memerlukan izin ini untuk melakukan langkah-langkah tambahan setelah aplikasi 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 API Center pada 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 permohonan Anda dan mengirimkan 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 harus 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 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 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 permohonan Anda dan mengirimkan email ke alamat email kontak API Anda yang berisi status persetujuan dan detail tambahan.

Memodifikasi 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 library.NET Google Ads API 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)

Jangan sertakan header developer-token dalam permintaan HTTP Anda:

curl -i -X POST https://googleads.googleapis.com/v20/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 adalah beberapa pertanyaan umum (FAQ) tentang Tingkat 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 cara Anda memerlukan project Konsol Google API untuk menggunakan Google Ads API saat ini.

Saya perlu mengubah tingkat Akses API saya. Bagaimana caranya?

Untuk saat ini, Anda harus terus menggunakan Pusat API untuk 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.

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

Anda akan mendapatkan 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 uji coba ini?

Secara umum, tidak, Anda tidak akan ditagih jika memilih untuk 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.

Kemungkinan skenario untuk mendapatkan organisasi Google Cloud adalah sebagai berikut:

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

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

2. Anda telah membuat akun edisi gratis Google Cloud Identity:

   Anda tidak akan dikenai biaya saat mendaftar ke akun Google Cloud Identity edisi gratis atau saat membuat organisasi Google Cloud untuk 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 ditagih.

Saya memiliki beberapa token developer untuk berbagai alat. 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 ada ke akun yang saya kelola menggunakan Google Ads API?

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

Saya 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 sifat masalah Anda. Sertakan detail seperti ID organisasi serta log permintaan dan respons jika memungkinkan.