Tingkat akses yang dikelola cloud

Dengan fitur ini, tingkat akses API Anda dapat dikelola oleh layanan Google Cloud organisasi, yang memberi Anda manfaat berikut:

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

  • Kelola project Konsol API Google yang terpisah untuk aplikasi yang berbeda: Setiap project yang ditautkan dalam organisasi Google Cloud mewarisi API tersebut tingkat akses organisasi. Hal ini memungkinkan Anda membuat beberapa Project Konsol API Google di bawah organisasi ini untuk tujuan seperti manajemen proyek terperinci, proyek 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 API penggunaan tiap 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 pada halaman akun pengelola Google Ads. Login, lalu buka ALAT & SETELAN > SIAPKAN > Pusat API.

  • Organisasi Google Cloud

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

    Skenario Langkah
    Anda adalah partner Google Workspace atau Google Cloud Identitas pelanggan Kemungkinannya adalah Anda sudah memiliki sumber daya organisasi. Anda dapat Cek dan buat satu jika diperlukan.
    Anda tidak menggunakan Google Workspace atau Google Cloud Identity Daftar ke edisi gratis Google Cloud Identity. Lalu buat resource organisasi Anda.
    Tidak ada opsi sebelumnya yang berhasil untuk Anda Jelaskan skenario Anda ketika menandatangani untuk uji coba dan meminta Google untuk membuat referensi organisasi keamanan untuk Anda. Google akan memiliki dan mengelola resource organisasi ini tanpa besar.

  • 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 telah mengaktifkan Google Ads API berada di bawah organisasi ini. Jika tidak, migrasikan di bawah organisasi.

    Jika Anda pelanggan Google Ads Workspace atau Google Cloud Google Identity, kemungkinan project Konsol API Google tersebut 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 pengelola Google Ads API dan project Konsol API Google Anda. Anda memerlukan izin ini untuk melakukan langkah tambahan setelah permohonan uji coba disetujui.

  • Email kontak API terbaru

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

Daftar untuk program uji coba

Daftar untuk mengikuti program uji coba. Tim Kepatuhan Google akan kemudian tinjau permohonan Anda dan kirimkan email ke alamat email kontak API Anda dengan status persetujuan dan detail tambahan.

Jika Anda meminta Google membuat organisasi Google Cloud untuk Anda, ada adalah beberapa langkah tambahan:

  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 project yang baru dibuat organisasi/pengaturan.

  2. Google akan mengirimkan email ke alamat email kontak API Anda dengan detail informasi 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 di organisasi yang 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 kepada API Anda alamat email kontak Anda dengan status persetujuan dan detail tambahan.

Mengubah permintaan API

Anda dapat mengubah aplikasi agar berhenti mengirim header developer-token saat melakukan panggilan API. Langkah ini bersifat opsional, tetapi direkomendasikan. Jika Anda berada di program uji coba, server Google Ads API akan mengabaikan developer-token jika dikirim sebagai bagian permintaan API.

Java

Segera hadir!

.NET

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

Berikutnya, ubah kode Anda seperti 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 di permintaan HTTP Anda:

curl -i -X POST https://googleads.googleapis.com/v17/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 saya harus menjadi pelanggan Google Workspace atau Google Cloud agar dapat menggunakan Google Ads API?

Tidak. Anda memerlukan organisasi Google Cloud yang dapat diperoleh di banyak cara tertentu. Persyaratan ini mirip dengan bagaimana Anda memerlukan Project Konsol API Google untuk menggunakan Google Ads API sekarang.

Saya perlu mengubah tingkat Akses API saya. Bagaimana caranya?

Untuk saat ini Anda harus terus menggunakan API Center 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 seharusnya bisa untuk menyelesaikan perubahan pada aplikasi mereka dalam waktu kurang dari 30 menit.

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

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

Skenario yang memungkinkan untuk mendapatkan organisasi Google Cloud adalah sebagai berikut berikut ini:

  1. Anda sudah menjadi pelanggan Google Workspace atau Google Cloud Identity:

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

  2. Anda membuat akun Google Cloud Identity Free Edition:

    Anda tidak akan ditagih saat mendaftar ke Google Cloud Identity edisi gratis atau untuk membuat organisasi Google Cloud dengan tujuan yang berpartisipasi dalam uji coba ini.

  3. Google telah membuat resource organisasi Cloud untuk Anda:

    Ini adalah resource organisasi Cloud internal yang dikelola Google sehingga Anda Anda tidak akan ditagih.

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

Kasus penggunaan ini tidak didukung, jadi Anda tidak dapat berpartisipasi dalam percontohan.

Apakah ini memengaruhi otorisasi API yang ada untuk akun yang saya kelola menggunakan Google Ads API?

Tidak, perubahan ini tidak memengaruhi otorisasi API yang sudah ada untuk Google Ads akun 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 dukungan teknis API halaman dan jelaskan masalah Anda. Sertakan Anda, seperti ID organisasi serta log permintaan dan respons saat sebaik mungkin.