Penginstalan
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Baik Anda menginstal library dari PyPI atau meng-clone-nya dari GitHub, sebaiknya lakukan langkah-langkah di bawah menggunakan lingkungan virtual yang aktif. Untuk mengetahui informasi tentang cara membuat dan mengaktifkan lingkungan virtual, lihat dokumentasi Virtual Environment.
Instal modul dari PyPI
Library didistribusikan di PyPI dan dapat
diinstal menggunakan pip dengan
perintah berikut:
python -m pip install google-ads
Menginstal library dari GitHub
Kode sumber untuk library dapat di-clone dari GitHub
ke komputer lokal Anda. Meng-clone kode sumber berguna untuk memudahkan
menjalankan contoh atau mengembangkan library itu sendiri. Sebagai referensi, menjalankan salah satu contoh autentikasi adalah langkah yang diperlukan dalam mengonfigurasi library untuk digunakan.
Pastikan python3.8 atau yang lebih baru ada di lingkungan Anda.
Cara paling sederhana adalah dengan menggunakan pyenv:
pyenv local 3.8
Clone library klien dari GitHub:
git clone git@github.com:googleads/google-ads-python.git
Masukkan repositori dan instal:
cd google-ads-python
python -m pip install .
Jika Anda berniat mengembangkan library, jalankan pengujian unit sebelum dan sesudah
melakukan perubahan:
Pastikan Anda memiliki semua versi bahasa Python yang didukung dan tersedia di
lingkungan Anda. Menggunakan pyenv::
pyenv local 3.8 3.9 3.10 3.11 3.12
Instal dependensi khusus pengujian library:
python -m pip install .[tests]
Jalankan pengujian unit untuk memastikan library berfungsi dengan benar:
nox
Opsional: pengujian unit juga dapat dijalankan menggunakan Docker. Pertama, Anda harus
menginstal Docker. Kemudian, dari
direktori google-ads-python, jalankan perintah berikut:
docker build -t google-ads-python:test .
docker run -it google-ads-python:test nox
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-27 UTC.
[null,null,["Terakhir diperbarui pada 2025-08-27 UTC."],[[["\u003cp\u003eThe Google Ads Python library can be installed from PyPI using pip with the command \u003ccode\u003epython -m pip install google-ads\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eTo install from GitHub, clone the repository, navigate into it, and run \u003ccode\u003epython -m pip install .\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eEnsure you have Python 3.8 or later installed in your environment, potentially using pyenv.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers should run unit tests before and after making changes, utilizing nox or Docker for execution.\u003c/p\u003e\n"],["\u003cp\u003eFor library setup and usage, refer to the Virtual Environment and authentication example documentation.\u003c/p\u003e\n"]]],[],null,["# Installation\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nWhether you're installing the library from PyPI or cloning it from GitHub, we\nrecommended that you conduct the below steps using an active virtual\nenvironment. For information on how to create and activate a virtual\nenvironment, see the [Virtual Environment](//docs.python.org/3/tutorial/venv.html) documentation.\n\nInstall the module from PyPI\n----------------------------\n\nThe library is distributed on [PyPI](//pypi.org/project/google-ads/) and can\nbe installed using [pip](//pip.pypa.io/en/stable/installing) with the\nfollowing command: \n\n python -m pip install google-ads\n\nInstall the library from GitHub\n-------------------------------\n\nThe source code for the library can be cloned from [GitHub](https://github.com/googleads/google-ads-python/)\nonto your local machine. It's useful to clone the source code in order to easily\nexecute the examples or to develop the library itself. For reference, running\none of the authentication examples is a required step in configuring the library\nfor use.\n\n1. Ensure that `python3.8` or later is present in your environment.\n The simplest way is to use [`pyenv`](//github.com/pyenv/pyenv-installer):\n\n pyenv local 3.8\n\n2. Clone the client library from GitHub:\n\n git clone git@github.com:googleads/google-ads-python.git\n\n3. Enter the repository and install it:\n\n cd google-ads-python\n python -m pip install .\n\n4. If you intend to develop the library, run the unit tests before and after\n making any changes:\n\n 1. Ensure you have all supported versions of the Python language available in\n your environment. Using `pyenv`::\n\n pyenv local 3.8 3.9 3.10 3.11 3.12\n\n 2. Install the test-specific dependencies of the library:\n\n python -m pip install .[tests]\n\n 3. Run the unit tests to ensure the library is functioning properly:\n\n nox\n\n 4. Optional: the unit tests can also be run using Docker. First, you must\n have [Docker installed](https://docs.docker.com/get-docker/). Then, from\n the `google-ads-python` directory, run the following:\n\n docker build -t google-ads-python:test .\n docker run -it google-ads-python:test nox"]]
