Pustaka klien ini menyederhanakan akses SOAP API Google Ad Manager. Perpustakaan menyediakan cara mudah untuk menyimpan otentikasi Anda dan membuat klien layanan web SOAP. Ini juga berisi kode contoh untuk membantu Anda mulai berintegrasi dengan API kami.
Unduh dan instal perpustakaan
setuptools adalah prasyarat untuk menginstal perpustakaan googleads
Disarankan agar Anda menginstal perpustakaan dan dependensinya dari PyPI menggunakan pip. Hal ini dapat dicapai dengan satu perintah:
$ pip install googleads
Sebagai alternatif, Anda dapat mengunduh perpustakaan sebagai tarball. Untuk memulai instalasi, navigasikan ke direktori yang berisi perpustakaan klien yang telah Anda unduh dan jalankan skrip "setup.py" sebagai berikut:
$ python setup.py build install
Salin file googleads.yaml ke direktori home Anda.
Ini akan digunakan untuk menyimpan kredensial dan pengaturan lain yang dapat dimuat untuk menginisialisasi klien.
Siapkan kredensial OAuth2 Anda
Ad Manager API menggunakan OAuth2 sebagai autentikasi
mekanisme. Ikuti panduan yang sesuai di bawah ini berdasarkan kasus penggunaan Anda.
Jika Anda mengakses API menggunakan kredensial Anda sendiri...
Jika Anda mengakses API atas nama klien...
Mengembangkan aplikasi web (Pengelola Iklan)
Menggunakan Pengelola Iklan
Anda dapat menemukan contoh kode untuk Ad Manager versi terbaru di halaman rilis.
Atau, Anda dapat menemukan contoh Ad Manager di direktori contoh repositori ini.
Dimungkinkan untuk menyimpan informasi autentikasi API Anda dalam cache. Pustaka menyertakan file contoh yang menunjukkan cara melakukan hal ini bernama googleads.yaml . Isi kolom untuk API dan fitur yang ingin Anda gunakan. Metode LoadFromStorage perpustakaan secara default mencari file dengan nama ini di direktori home Anda, namun Anda bisa meneruskan jalur ke file apa pun dengan konten yaml yang benar.
# Gunakan lokasi default - direktori home Anda:ad_manager_client = ad_manager.AdManagerClient.LoadFromStorage()# Alternatifnya, teruskan lokasi file:ad_manager_client = ad_manager.AdManagerClient.LoadFromStorage('C:MyDirectorygoogleads.yaml')Jika Anda memiliki masalah yang terkait langsung dengan pustaka klien, gunakan pelacak masalah.
Jika Anda mengalami masalah terkait API tertentu, gunakan forum dukungan produk:
Manajer Iklan
Perpustakaan menggunakan kerangka logging bawaan Python. Anda dapat menentukan konfigurasi Anda melalui file konfigurasi; lihat googleads.yaml sebagai contoh.
Alternatifnya, Anda dapat menentukan konfigurasi logging Anda secara manual. Misalnya, jika Anda ingin mencatat interaksi SOAP Anda ke stdout, dan Anda menggunakan perpustakaan sabun Zeep, Anda dapat melakukan hal berikut:
logging.basicConfig(level=logging.INFO, format=googleads.util.LOGGER_FORMAT)logging.getLogger('googleads.soap').setLevel(logging.DEBUG)Jika Anda ingin login ke suatu file, Anda harus melampirkan pengendali log ke sumber ini yang dikonfigurasi untuk menulis output ke file.
Plugin zeep yang digunakan untuk logging menghapus data sensitif dari outputnya. Jika Anda ingin data ini disertakan dalam log, Anda harus mengimplementasikan plugin logging sederhana Anda sendiri. Misalnya:
kelas DangerousZeepLogger(zeep.Plugin): def ingress(mandiri, amplop, http_headers, operasi):logging.debug('Respon masuk: n%s', etree.tostring(envelope, Pretty_print=True))amplop kembali, http_headers
def egress(mandiri, amplop, http_headers, operasi, binding_options):logging.debug('Respon masuk: n%s', etree.tostring(envelope, Pretty_print=True))return envelope, http_headersad_manager_client.zeep_client.plugins.append(DangerousZeepLogger ())Secara default, klien di-cache karena membaca dan mencerna WSDL bisa jadi mahal. Namun, metode caching default memerlukan izin untuk mengakses sistem file lokal yang mungkin tidak tersedia di lingkungan hosting tertentu seperti App Engine.
Anda dapat meneruskan implementasi zeep.cache.Base ke penginisialisasi AdManagerClient untuk mengubah perilaku cache default.
Misalnya, mengkonfigurasi lokasi dan durasi file cache yang berbeda dengan zeep
doc_cache = zeep.cache.SqliteCache(path=cache_path)ad_manager_client = ad_manager.AdManagerClient( oauth2_client, nama_aplikasi, kode_jaringan=kode_jaringan, cache=doc_cache)
Anda juga dapat menonaktifkan caching dengan cara serupa dengan zeep
ad_manager_client = ad_manager.AdManagerClient( oauth2_client, nama_aplikasi, kode_jaringan=kode_jaringan, cache=googleads.common.ZeepServiceProxy.NO_CACHE)
Perpustakaan ini hanya mendukung Python 3.7+.
- httplib2 -- https://pypi.python.org/pypi/httplib2/ - oauth2client -- https://pypi.python.org/pypi/oauth2client/ - pysocks -- https://pypi.python.org/pypi/PySocks/ - pytz -- https://pypi.python.org/pypi/pytz - pyYAML -- https://pypi.python.org/pypi/pyYAML/ - xmltodict -- https://pypi.python.org/pypi/xmltodict/ - zeep -- https://pypi.python.org/pypi/zeep - mock -- https://pypi.python.org/pypi/mock (only needed to run unit tests) - pyfakefs -- https://pypi.python.org/pypi/pyfakefs (only needed to run unit tests)
Mark Saniscalchi David Wihl Ben Karl
