google-ads-api 8.0.0 → 9.0.0

package/README.md

@@ -7,7 +7,7 @@
 </p>
 <p align="center">
   <a href="https://developers.google.com/google-ads/api/docs/release-notes">
-    <img src="https://img.shields.io/badge/google%20ads-v8-009688.svg?style=flat-square">
+    <img src="https://img.shields.io/badge/google%20ads-v9.1.0-009688.svg?style=flat-square">
   </a>
   <a href="https://www.npmjs.com/package/google-ads-api">
     <img src="https://img.shields.io/npm/v/google-ads-api.svg?style=flat-square">
@@ -33,7 +33,7 @@
 - Typescript definitions for all resources, enums, errors and services
 - Provides all API functionality
 
-> The Google Ads API is the new replacement to the AdWords API. Google will deprecate the AdWords API sometime in 2020.
+> The Google Ads API is the new replacement to the AdWords API. Google will deprecate the AdWords API on the 27th of April, 2022.
 
 # Hiring
 
@@ -45,18 +45,6 @@ We're currently hiring full-stack engineers at [Opteo](https://opteo.com)! If yo
 npm install google-ads-api
 ```
 
-# Documentation
-
-**Note:** Our documentation site is currently outdated (an older version of this library and the Google Ads API) but is still up. We're working on updating these docs soon.
-
----
-
-### ➡️ [opteo.com/dev/google-ads-api](https://opteo.com/dev/google-ads-api)
-
----
-
-For now we recommend following the usage examples below.
-
 # Usage
 
 - Setup
@@ -114,7 +102,7 @@ const customer = client.Customer({
 
 ## List accessible customers
 
-This is a special client method for listing the accessible customers for a given refresh token, and is equivalent to [CustomerService.listAccessibleCustomers](https://developers.google.com/google-ads/api/reference/rpc/v8/CustomerService#listaccessiblecustomers). It returns the resource names of available customer accounts.
+This is a special client method for listing the accessible customers for a given refresh token, and is equivalent to [CustomerService.listAccessibleCustomers](https://developers.google.com/google-ads/api/reference/rpc/v9/CustomerService#listaccessiblecustomers). It returns the resource names of available customer accounts.
 
 ```ts
 const client = new GoogleAdsApi({
@@ -307,6 +295,8 @@ const adGroupAd = new resources.AdGroupAd({
 const { results } = await cus.adGroupAds.create([adGroupAd]);
 ```
 
+---
+
 ## Create a Campaign & Budget atomically
 
 ```ts
@@ -361,6 +351,8 @@ const operations: MutateOperation<
 const result = await customer.mutateResources(operations);
 ```
 
+---
+
 ## Summary Row
 
 If a summary row is requested in the `report` method, it will be included as the **first** row of the results.
@@ -394,7 +386,7 @@ const summaryRow = accumulator.slice(-1)[0];
 
 ## Total Results Count
 
-The `reportCount` method acts like `report` but returns the total number of rows that the query would have returned (ignoring the limit). This replaces the `return_total_results_count` report option. No hooks are called in this function to avoid cacheing conflicts.
+The `reportCount` method acts like `report` but returns the total number of rows that the query would have returned (ignoring the limit). This replaces the `return_total_results_count` report option. Hooks are **not** called in this function to avoid cacheing conflicts.
 
 ```ts
 const totalRows = await customer.reportCount({
@@ -570,11 +562,13 @@ const customer = client.Customer({
 });
 ```
 
+---
+
 ## Error handling
 
-All errors, apart from GRPC specific cases (such as a connection problem or timeout, [see more here](https://github.com/grpc/grpc/blob/master/doc/statuscodes.md)), are instances of a [GoogleAdsFailure](https://developers.google.com/google-ads/api/reference/rpc/v8/GoogleAdsFailure).
+All errors, apart from GRPC specific cases (such as a connection problem or timeout, [see more here](https://github.com/grpc/grpc/blob/master/doc/statuscodes.md)), are instances of a [GoogleAdsFailure](https://developers.google.com/google-ads/api/reference/rpc/v9/GoogleAdsFailure).
 
-You can find a list of all error types for a specific version in [the official documentation](https://developers.google.com/google-ads/api/reference/rpc/v8/AccessInvitationErrorEnum.AccessInvitationError), as well as more information about [handling errors here](https://developers.google.com/google-ads/api/docs/best-practices/error-types).
+You can find a list of all error types for a specific version in [the official documentation](https://developers.google.com/google-ads/api/reference/rpc/v9/AccessInvitationErrorEnum.AccessInvitationError), as well as more information about [handling errors here](https://developers.google.com/google-ads/api/docs/best-practices/error-types).
 
 ```ts
 import { errors } from "google-ads-api";