Metadata-Version: 2.4
Name: google-ads-datamanager-util
Version: 0.4.0rc2
Summary: Utilities for the Data Manager API
Author-email: Google LLC <googleapis-packages@google.com>
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/googleads/data-manager-python
Project-URL: Documentation, https://developers.google.com/data-manager/api/get-started/set-up-access#python
Project-URL: Repository, https://github.com/googleads/data-manager-python
Project-URL: Issue Tracker, https://github.com/googleads/data-manager-python/issues
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.10
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: PyYAML<7.0,>=5.1
Requires-Dist: tink~=1.11
Requires-Dist: tink[gcpkms]~=1.11
Requires-Dist: typing_extensions
Provides-Extra: dev
Requires-Dist: black[jupyter]; extra == "dev"
Requires-Dist: nox>=2026.7.11; extra == "dev"
Requires-Dist: google-ads-datamanager-util[samples]; extra == "dev"
Provides-Extra: samples
Requires-Dist: google-ads-datamanager~=0.1; extra == "samples"
Dynamic: license-file

Data Manager API utilities and samples for Python
=================================================

Utilities and code samples for working with the Data Manager API and Python.

Requirements
------------
* Python 3.10+

Installation
------------

.. code-block:: bash

  pip install google-ads-datamanager-util

Documentation
-------------
Please refer to our `Developer Site`_ for documentation on how to install,
configure, and use this client library.

Run samples
-----------

Samples are provided in the ``samples/`` directory, and the ``samples/sampledata``
directory contains samples of input files you can use with the samples.

To run a sample, first install the sample dependencies:

.. code-block:: bash

   pip install -r samples/requirements.txt

Then invoke the sample script using the command line. You can pass
arguments to the script in one of two ways:

1. Explicitly, on the command line
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. code-block:: bash

   python3 samples/events/ingest_events.py \
     --operating_account_type='GOOGLE_ADS' \
     --operating_account_id='<operating_account_id>' \
     --conversion_action_id='<conversion_action_id>' \
     --json_file='</path/to/your/file>'

2. Using an arguments file
~~~~~~~~~~~~~~~~~~~~~~~~~~

You can also save arguments in a file, with one argument per line.

.. code-block:: text

   --operating_account_type
   GOOGLE_ADS
   --operating_account_id
   <operating_account_id>
   --conversion_action_id
   <conversion_action_id>
   --json_file
   </path/to/your/file>

Then, run the sample by passing the file path, prefixed with the ``@``
character.

.. code-block:: bash

   python3 samples/events/ingest_events.py @/path/to/your/args.txt


Issue tracker
-------------

https://github.com/googleads/data-manager-python/issues

Contributing
------------

Contributions welcome! See the `Contributing Guide <CONTRIBUTING.md>`_.

Authors
-------

* `Josh Radcliff`_
* `Lindsey Volta`_

.. _Developer Site: https://developers.google.com/data-manager/api/get-started/set-up-access#python
.. _Josh Radcliff: https://github.com/jradcliff
.. _Lindsey Volta: https://github.com/lindsey-volta
