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 khawatir tentang mengamankan token developer atau membocorkannya. Anda dapat melewati pengiriman token developer dalam panggilan API, meskipun Anda masih perlu mengirim token akses.

  • Mengelola project Konsol API Google terpisah untuk aplikasi yang berbeda: Project apa pun yang ditautkan dalam organisasi Google Cloud akan mewarisi tingkat akses API organisasi. Hal ini memungkinkan Anda membuat beberapa project Konsol API Google dalam 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 akurat: Anda dapat memantau penggunaan API dari 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 ke 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 besar Anda sudah memiliki resource organisasi. Anda dapat Memeriksa dan membuatnya 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 mendaftar untuk uji coba dan meminta Google untuk 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 perlu menyiapkan project Konsol Google API 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 akun tersebut di bawah organisasi.

    Jika Anda adalah pelanggan Google Workspace atau Google Cloud Identity yang sudah ada, 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 Google API. Anda memerlukan izin ini untuk melakukan langkah-langkah tambahan setelah permohonan uji coba Anda disetujui.

  • Email kontak API terbaru

    Pastikan email kontak Google Ads API Anda sudah yang terbaru. Detail kontak API Anda tercantum di halaman API Center di akun pengelola Google Ads API Anda. Login, lalu buka TOOLS & SETTINGS > SETUP > API Center.

Mendaftar ke program uji coba

Daftar ke program uji coba. Tim Kepatuhan Google kemudian akan meninjau permohonan Anda dan mengirim email ke alamat email kontak API Anda dengan status persetujuan dan detail tambahan.

Jika Anda meminta Google untuk membuat 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 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 di bawah organisasi baru.

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

  5. Tim Kepatuhan Google akan meninjau permohonan Anda dan mengirim email ke alamat email kontak API Anda dengan 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 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)

Hapus header developer-token dalam permintaan HTTP Anda:

curl -i -X POST https://googleads.googleapis.com/v18/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 untuk menggunakan Google Ads API?

Tidak. Anda memerlukan organisasi Google Cloud yang dapat diperoleh dengan banyak 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 melihat perubahan kode minimal. Sebagian besar developer akan dapat menyelesaikan perubahan pada aplikasi mereka dalam waktu kurang dari 30 menit.

Apakah saya akan ditagih jika memilih untuk mengikuti uji coba ini?

Secara umum, tidak, Anda tidak akan ditagih jika memilih untuk mengikuti 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 untuk mendapatkan organisasi Google Cloud adalah sebagai berikut:

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

    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 membuat akun edisi gratis Google Cloud Identity:

    Anda tidak akan ditagih 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 ditagih.

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

Kasus penggunaan ini tidak didukung sehingga Anda tidak akan 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 Anda serta log permintaan dan respons jika memungkinkan.