google api python client

Klien Google API

Ini adalah pustaka klien Google API Python untuk API berbasis penemuan Google. Untuk memulai, silakan lihat folder docs.

Library ini dianggap lengkap dan berada dalam mode pemeliharaan. Artinya, kami akan mengatasi bug kritis dan masalah keamanan namun tidak akan menambahkan fitur baru apa pun.

Perpustakaan ini secara resmi didukung oleh Google. Namun, pengelola repositori ini merekomendasikan penggunaan Cloud Client Libraries for Python, jika memungkinkan, untuk pengembangan kode baru. Untuk informasi lebih lanjut, silakan kunjungi Penjelasan Perpustakaan Klien.

Rilis Versi 2.0

Rilis 2.0 dari google-api-python-client mencakup peningkatan keandalan yang substansial, dibandingkan dengan 1.x, karena dokumen penemuan kini disimpan dalam cache di perpustakaan, bukan diambil secara dinamis. Sangat disarankan untuk mengupgrade dari v1.x ke v2.x.

Hanya python 3.7 dan yang lebih baru yang didukung. Jika Anda tidak dapat memutakhirkan python, silakan terus gunakan versi 1.x karena kami akan terus mendukung python 2.7+ di v1.

Dokumen penemuan tidak akan diambil lagi secara dinamis saat Anda memanggil discovery.build() . Dokumen penemuan akan diambil langsung dari perpustakaan klien. Versi baru perpustakaan ini dirilis setiap minggu. Sebagai hasil dari cache dokumen penemuan, ukuran paket ini setidaknya 50 MB lebih besar dibandingkan versi sebelumnya.

Silakan lihat Panduan Migrasi untuk informasi lebih lanjut.

Dokumentasi

Lihat folder docs untuk petunjuk lebih rinci dan dokumentasi tambahan.

Pustaka Google API lainnya

Pengelola repositori ini merekomendasikan penggunaan Cloud Client Libraries for Python, jika memungkinkan, untuk pengembangan kode baru karena alasan berikut:

Dengan Library Klien Cloud untuk Python:

• Terdapat perpustakaan klien terpisah untuk setiap API, sehingga Anda dapat memilih perpustakaan klien mana yang akan diunduh. Padahal, google-api-python-client adalah perpustakaan klien tunggal untuk semua API. Akibatnya, total ukuran paket untuk google-api-python-client melebihi 50 MB.
• Terdapat kontrol yang lebih ketat untuk menghentikan perubahan pada API yang mendasarinya karena setiap pustaka klien berfokus pada API tertentu.
• Terdapat lebih banyak fitur di Pustaka Klien Cloud ini karena setiap pustaka berfokus pada API tertentu, dan dalam beberapa kasus, pustaka dimiliki oleh tim yang berspesialisasi dalam API tersebut.
• Pengembang akan mendapat manfaat dari intellisense.

Untuk informasi lebih lanjut, silakan kunjungi Penjelasan Perpustakaan Klien.

Meskipun ada banyak keuntungan berpindah ke Cloud Client Libraries untuk Python, pengelola ingin menekankan bahwa google-api-python-client akan terus didukung.

Untuk Google Ads API, sebaiknya gunakan Pustaka Klien Google Ads API untuk Python.

Untuk Google Firebase Admin API, sebaiknya gunakan Firebase Admin Python SDK.

Instalasi

Instal perpustakaan ini di virtualenv menggunakan pip. virtualenv adalah alat untuk membuat lingkungan Python yang terisolasi. Masalah dasar yang diatasinya adalah ketergantungan dan versi, serta izin tidak langsung.

Dengan virtualenv, dimungkinkan untuk menginstal perpustakaan ini tanpa memerlukan izin instalasi sistem, dan tanpa bentrok dengan dependensi sistem yang diinstal.

Mac/Linux

pip3 install virtualenv
virtualenv < your-env >
source < your-env > /bin/activate
< your-env > /bin/pip install google-api-python-client

jendela

pip install virtualenv
virtualenv < your-env >
< your-env > Scriptsactivate
< your-env > Scriptspip.exe install google-api-python-client

Versi Python yang Didukung

Python 3.7, 3.8, 3.9, 3.10, 3.11 dan 3.12 didukung dan diuji sepenuhnya. Pustaka ini mungkin berfungsi pada versi 3 yang lebih baru, namun saat ini kami tidak menjalankan pengujian terhadap versi tersebut.

Versi Python tidak didukung

ular piton <3.7

Perpustakaan dan Ketergantungan Pihak Ketiga

Pustaka berikut akan diinstal ketika Anda menginstal pustaka klien:

• httplib2
• templat uri

Untuk pengembangan, Anda juga memerlukan perpustakaan berikut:

• Tes Web
• pyopenssl

Berkontribusi

Silakan lihat Panduan Kontribusi kami. Secara khusus, kami menyukai permintaan penarikan - namun pastikan untuk menandatangani perjanjian lisensi kontributor.