google-ads-api 11.1.0 → 12.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +19 -16
- package/build/src/protos/autogen/enums.d.ts +402 -341
- package/build/src/protos/autogen/enums.js +401 -338
- package/build/src/protos/autogen/fields.d.ts +129 -101
- package/build/src/protos/autogen/fields.js +16 -3
- package/build/src/protos/autogen/resourceNames.d.ts +33 -8
- package/build/src/protos/autogen/resourceNames.js +45 -14
- package/build/src/protos/autogen/serviceFactory.d.ts +181 -186
- package/build/src/protos/autogen/serviceFactory.js +536 -711
- package/build/src/protos/index.d.ts +6 -6
- package/build/src/protos/index.js +5 -5
- package/build/src/query.d.ts +5 -1
- package/build/src/query.js +16 -3
- package/build/src/types.d.ts +1 -0
- package/build/src/version.d.ts +1 -1
- package/build/src/version.js +1 -1
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
</p>
|
|
8
8
|
<p align="center">
|
|
9
9
|
<a href="https://developers.google.com/google-ads/api/docs/release-notes">
|
|
10
|
-
<img src="https://img.shields.io/badge/google%20ads-
|
|
10
|
+
<img src="https://img.shields.io/badge/google%20ads-v12.0.0-009688.svg?style=flat-square">
|
|
11
11
|
</a>
|
|
12
12
|
<a href="https://www.npmjs.com/package/google-ads-api">
|
|
13
13
|
<img src="https://img.shields.io/npm/v/google-ads-api.svg?style=flat-square">
|
|
@@ -99,7 +99,7 @@ const customer = client.Customer({
|
|
|
99
99
|
|
|
100
100
|
## List accessible customers
|
|
101
101
|
|
|
102
|
-
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/
|
|
102
|
+
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/v12/CustomerService#listaccessiblecustomers). It returns the resource names of available customer accounts.
|
|
103
103
|
|
|
104
104
|
```ts
|
|
105
105
|
const client = new GoogleAdsApi({
|
|
@@ -563,10 +563,11 @@ const onQueryStart: OnQueryStart = async ({ cancel, editOptions }) => {
|
|
|
563
563
|
}
|
|
564
564
|
};
|
|
565
565
|
|
|
566
|
-
const customer = client.Customer(
|
|
567
|
-
|
|
568
|
-
|
|
569
|
-
|
|
566
|
+
const customer = client.Customer(
|
|
567
|
+
{
|
|
568
|
+
clientOptions,
|
|
569
|
+
customerOptions,
|
|
570
|
+
},
|
|
570
571
|
{ onQueryStart }
|
|
571
572
|
);
|
|
572
573
|
```
|
|
@@ -587,10 +588,11 @@ const onQueryError: OnQueryError = async ({ error }) => {
|
|
|
587
588
|
console.log(error.message); // An Error or a GoogleAdsFailure
|
|
588
589
|
};
|
|
589
590
|
|
|
590
|
-
const customer = client.Customer(
|
|
591
|
-
|
|
592
|
-
|
|
593
|
-
|
|
591
|
+
const customer = client.Customer(
|
|
592
|
+
{
|
|
593
|
+
clientOptions,
|
|
594
|
+
customerOptions,
|
|
595
|
+
},
|
|
594
596
|
{ onQueryError }
|
|
595
597
|
);
|
|
596
598
|
```
|
|
@@ -611,10 +613,11 @@ const onQueryEnd: OnQueryEnd = async ({ response, resolve }) => {
|
|
|
611
613
|
resolve([first]); // The supplied argument will become the alternative return value
|
|
612
614
|
};
|
|
613
615
|
|
|
614
|
-
const customer = client.Customer(
|
|
615
|
-
|
|
616
|
-
|
|
617
|
-
|
|
616
|
+
const customer = client.Customer(
|
|
617
|
+
{
|
|
618
|
+
clientOptions,
|
|
619
|
+
customerOptions,
|
|
620
|
+
},
|
|
618
621
|
{ onQueryEnd }
|
|
619
622
|
);
|
|
620
623
|
```
|
|
@@ -623,9 +626,9 @@ const customer = client.Customer({
|
|
|
623
626
|
|
|
624
627
|
## Error handling
|
|
625
628
|
|
|
626
|
-
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/
|
|
629
|
+
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/v12/GoogleAdsFailure).
|
|
627
630
|
|
|
628
|
-
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/
|
|
631
|
+
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/v12/AccessInvitationErrorEnum.AccessInvitationError), as well as more information about [handling errors here](https://developers.google.com/google-ads/api/docs/best-practices/error-types).
|
|
629
632
|
|
|
630
633
|
```ts
|
|
631
634
|
import { errors } from "google-ads-api";
|