Changes for release v22. (#1032)

Author: BenRKarl

ChangeLog

@@ -1,3 +1,6 @@
+* 28.1.0
+- Google Ads API v22_0 release.
+
 * 28.0.0
 - Google Ads API v21_0 release.
 - Updated to Google Ads API v19_0 and v20_0 to include EU political advertising changes.

Dockerfile

@@ -1,40 +1,25 @@
-ARG image_name=ubuntu:20.04
-FROM ${image_name}
+FROM ubuntu:24.04
 
 ARG DEBIAN_FRONTEND=noninteractive
+ARG PYTHON_VERSIONS="3.13 3.12 3.11 3.10 3.9"
+
 ENV TZ=Etc/GMT
+ENV PATH="$PATH:/root/.local/bin"
+ENV NOX_DEFAULT_VENV_BACKEND=uv
+
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /bin/uv
 COPY . /google-ads-python
+
+RUN uv python install ${PYTHON_VERSIONS} && \
+    uv tool install nox[uv]
+
 RUN apt-get update -qy && \
+    apt-get upgrade -qy && \
     apt-get install -qy --no-install-recommends \
         ca-certificates \
         curl \
-        gnupg2 && \
-    . /etc/os-release && \
-    echo "deb http://ppa.launchpad.net/deadsnakes/ppa/ubuntu ${UBUNTU_CODENAME} main" > /etc/apt/sources.list.d/deadsnakes.list && \
-    apt-key adv --keyserver keyserver.ubuntu.com --recv-keys F23C5A6CF475977595C89F51BA6932366A755776 && \
-    apt-get update -qy && \
-    apt-get install -qy --no-install-recommends \
+        gnupg2 \
         git \
-        openssh-client \
-        python3.8 \
-        python3.8-distutils \
-        python3.9 \
-        python3.10 \
-        python3.11 \
-        python3.12 && \
-    curl -fsSo /tmp/get-pip.py https://bootstrap.pypa.io/pip/3.8/get-pip.py && \
-    python3.8 /tmp/get-pip.py && \
-    python3.8 -m pip install --no-cache-dir --upgrade pip && \
-    python3.9 /tmp/get-pip.py && \
-    python3.9 -m pip install --no-cache-dir --upgrade pip && \
-    python3.10 /tmp/get-pip.py && \
-    python3.10 -m pip install --no-cache-dir --upgrade pip && \
-    python3.11 /tmp/get-pip.py && \
-    python3.11 -m pip install --no-cache-dir --upgrade pip && \
-    python3.12 /tmp/get-pip.py && \
-    python3.12 -m pip install --no-cache-dir --upgrade pip && \
-    rm /tmp/get-pip.py && \
-    python3 -m pip install --no-cache-dir "nox>=2020.12.31,<2022.6" && \
-    rm -rf /var/cache/apt/lists
+        openssh-client
 
 WORKDIR "/google-ads-python"

examples/account_management/create_customer.py

@@ -27,11 +27,11 @@
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
-from google.ads.googleads.v21.resources.types.customer import Customer
-from google.ads.googleads.v21.services.services.customer_service.client import (
+from google.ads.googleads.v22.resources.types.customer import Customer
+from google.ads.googleads.v22.services.services.customer_service.client import (
     CustomerServiceClient,
 )
-from google.ads.googleads.v21.services.types.customer_service import (
+from google.ads.googleads.v22.services.types.customer_service import (
     CreateCustomerClientResponse,
 )
 
@@ -91,7 +91,7 @@ def main(client: GoogleAdsClient, manager_customer_id: str) -> None:
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v21")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v22")
 
     try:
         main(googleads_client, args.manager_customer_id)

examples/account_management/get_account_hierarchy.py

@@ -28,16 +28,16 @@
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
-from google.ads.googleads.v21.services.services.google_ads_service.client import (
+from google.ads.googleads.v22.services.services.google_ads_service.client import (
     GoogleAdsServiceClient,
 )
-from google.ads.googleads.v21.services.services.customer_service.client import (
+from google.ads.googleads.v22.services.services.customer_service.client import (
     CustomerServiceClient,
 )
-from google.ads.googleads.v21.resources.types.customer_client import (
+from google.ads.googleads.v22.resources.types.customer_client import (
     CustomerClient,
 )
-from google.ads.googleads.v21.services.types.google_ads_service import (
+from google.ads.googleads.v22.services.types.google_ads_service import (
     SearchPagedResponse,
     GoogleAdsRow,
 )
@@ -238,7 +238,7 @@ def print_account_hierarchy(
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v21")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v22")
     try:
         main(googleads_client, args.login_customer_id)
     except GoogleAdsException as ex:

examples/account_management/get_change_details.py

@@ -28,15 +28,15 @@
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
 from google.ads.googleads.util import get_nested_attr
-from google.ads.googleads.v21.services.services.google_ads_service.client import (
+from google.ads.googleads.v22.services.services.google_ads_service.client import (
     GoogleAdsServiceClient,
 )
-from google.ads.googleads.v21.services.types.google_ads_service import (
+from google.ads.googleads.v22.services.types.google_ads_service import (
     SearchGoogleAdsRequest,
     SearchPagedResponse,
     GoogleAdsRow,
 )
-from google.ads.googleads.v21.resources.types.change_event import ChangeEvent
+from google.ads.googleads.v22.resources.types.change_event import ChangeEvent
 
 
 # [START get_change_details]
@@ -218,7 +218,7 @@ def main(client: GoogleAdsClient, customer_id: str) -> None:
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v21")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v22")
     try:
         main(googleads_client, args.customer_id)
     except GoogleAdsException as ex:

examples/account_management/get_change_summary.py

@@ -22,15 +22,15 @@
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
-from google.ads.googleads.v21.services.services.google_ads_service.client import (
+from google.ads.googleads.v22.services.services.google_ads_service.client import (
     GoogleAdsServiceClient,
 )
-from google.ads.googleads.v21.services.types.google_ads_service import (
+from google.ads.googleads.v22.services.types.google_ads_service import (
     SearchGoogleAdsRequest,
     SearchPagedResponse,
     GoogleAdsRow,
 )
-from google.ads.googleads.v21.resources.types.change_status import ChangeStatus
+from google.ads.googleads.v22.resources.types.change_status import ChangeStatus
 
 
 # [START get_change_summary]
@@ -110,7 +110,7 @@ def main(client: GoogleAdsClient, customer_id: str) -> None:
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v21")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v22")
 
     try:
         main(googleads_client, args.customer_id)

examples/account_management/invite_user_with_access_role.py

@@ -23,18 +23,18 @@
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
-from google.ads.googleads.v21.services.services.customer_user_access_invitation_service.client import (
+from google.ads.googleads.v22.services.services.customer_user_access_invitation_service.client import (
     CustomerUserAccessInvitationServiceClient,
 )
-from google.ads.googleads.v21.services.types.customer_user_access_invitation_service import (
+from google.ads.googleads.v22.services.types.customer_user_access_invitation_service import (
     CustomerUserAccessInvitationOperation,
     MutateCustomerUserAccessInvitationResponse,
 )
-from google.ads.googleads.v21.resources.types.customer_user_access_invitation import (
+from google.ads.googleads.v22.resources.types.customer_user_access_invitation import (
     CustomerUserAccessInvitation,
 )
 
-# AccessRoleEnum is part of google.ads.googleads.v19.enums.types.access_role
+# AccessRoleEnum is part of google.ads.googleads.v22.enums.types.access_role
 # but it's accessed via client.enums.AccessRoleEnum, so direct import for type hint might not be strictly needed for the parameter.
 # The field invitation.access_role expects an int (the enum value).
 
@@ -115,7 +115,7 @@ def main(
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v21")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v22")
 
     try:
         main(

examples/account_management/link_manager_to_client.py

@@ -22,31 +22,31 @@
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
-from google.ads.googleads.v21.services.services.customer_client_link_service.client import (
+from google.ads.googleads.v22.services.services.customer_client_link_service.client import (
     CustomerClientLinkServiceClient,
 )
-from google.ads.googleads.v21.services.types.customer_client_link_service import (
+from google.ads.googleads.v22.services.types.customer_client_link_service import (
     CustomerClientLinkOperation,
     MutateCustomerClientLinkResponse,
 )
-from google.ads.googleads.v21.resources.types.customer_client_link import (
+from google.ads.googleads.v22.resources.types.customer_client_link import (
     CustomerClientLink,
 )
-from google.ads.googleads.v21.services.services.google_ads_service.client import (
+from google.ads.googleads.v22.services.services.google_ads_service.client import (
     GoogleAdsServiceClient,
 )
-from google.ads.googleads.v21.services.types.google_ads_service import (
+from google.ads.googleads.v22.services.types.google_ads_service import (
     SearchPagedResponse,
     GoogleAdsRow,
 )
-from google.ads.googleads.v21.services.services.customer_manager_link_service.client import (
+from google.ads.googleads.v22.services.services.customer_manager_link_service.client import (
     CustomerManagerLinkServiceClient,
 )
-from google.ads.googleads.v21.services.types.customer_manager_link_service import (
+from google.ads.googleads.v22.services.types.customer_manager_link_service import (
     CustomerManagerLinkOperation,
     MutateCustomerManagerLinkResponse,
 )
-from google.ads.googleads.v21.resources.types.customer_manager_link import (
+from google.ads.googleads.v22.resources.types.customer_manager_link import (
     CustomerManagerLink,
 )
 
@@ -179,7 +179,7 @@ def main(
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v21")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v22")
     try:
         main(googleads_client, args.customer_id, args.manager_customer_id)
     except GoogleAdsException as ex:

examples/account_management/list_accessible_customers.py

@@ -26,10 +26,10 @@
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
-from google.ads.googleads.v21.services.services.customer_service.client import (
+from google.ads.googleads.v22.services.services.customer_service.client import (
     CustomerServiceClient,
 )
-from google.ads.googleads.v21.services.types.customer_service import (
+from google.ads.googleads.v22.services.types.customer_service import (
     ListAccessibleCustomersResponse,
 )
 
@@ -55,7 +55,7 @@ def main(client: GoogleAdsClient) -> None:
 if __name__ == "__main__":
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v21")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v22")
 
     try:
         main(googleads_client)

examples/account_management/update_user_access.py

@@ -26,20 +26,20 @@
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
-from google.ads.googleads.v21.services.services.google_ads_service.client import (
+from google.ads.googleads.v22.services.services.google_ads_service.client import (
     GoogleAdsServiceClient,
 )
-from google.ads.googleads.v21.services.types.google_ads_service import (
+from google.ads.googleads.v22.services.types.google_ads_service import (
     SearchGoogleAdsRequest,
     SearchPagedResponse,
 )
-from google.ads.googleads.v21.resources.types.customer_user_access import (
+from google.ads.googleads.v22.resources.types.customer_user_access import (
     CustomerUserAccess,
 )
-from google.ads.googleads.v21.services.services.customer_user_access_service.client import (
+from google.ads.googleads.v22.services.services.customer_user_access_service.client import (
     CustomerUserAccessServiceClient,
 )
-from google.ads.googleads.v21.services.types.customer_user_access_service import (
+from google.ads.googleads.v22.services.types.customer_user_access_service import (
     CustomerUserAccessOperation,
     MutateCustomerUserAccessResponse,
 )
@@ -219,7 +219,7 @@ def modify_user_access(
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v21")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v22")
     try:
         main(
             googleads_client,