@google-cloud/nodejs-common 1.7.2-alpha → 1.7.9-alpha

package/bin/install_functions.sh

@@ -92,6 +92,7 @@ declare -A GOOGLE_CLOUD_APIS
 GOOGLE_CLOUD_APIS=(
   ["appengine.googleapis.com"]="App Engine Admin API"
   ["cloudbuild.googleapis.com"]="Google Build API"
+  ["artifactregistry.googleapis.com"]="Artifact Registry API"
   ["cloudresourcemanager.googleapis.com"]="Resource Manager API"
   ["iam.googleapis.com"]="Cloud Identity and Access Management API"
 )

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@google-cloud/nodejs-common",
-  "version": "1.7.2-alpha",
+  "version": "1.7.9-alpha",
   "description": "A NodeJs common library for solutions based on Cloud Functions",
   "author": "Google Inc.",
   "license": "Apache-2.0",
@@ -16,26 +16,26 @@
   },
   "homepage": "https://github.com/GoogleCloudPlatform/cloud-for-marketing/blob/master/marketing-analytics/activation/common-libs/nodejs-common/README.md",
   "dependencies": {
-    "@google-cloud/aiplatform": "^2.13.0",
-    "@google-cloud/automl": "^3.1.3",
-    "@google-cloud/bigquery": "^6.2.0",
-    "@google-cloud/datastore": "^7.5.1",
-    "@google-cloud/firestore": "^6.5.0",
-    "@google-cloud/logging-winston": "^5.3.0",
-    "@google-cloud/pubsub": "^3.6.0",
-    "@google-cloud/storage": "^6.10.1",
-    "@google-cloud/scheduler": "^3.3.1",
-    "@google-cloud/secret-manager": "^4.2.2",
-    "gaxios": "^5.1.0",
+    "@google-cloud/aiplatform": "^3.0.0",
+    "@google-cloud/automl": "^4.0.0",
+    "@google-cloud/bigquery": "^7.2.0",
+    "@google-cloud/datastore": "^8.0.0",
+    "@google-cloud/firestore": "^6.7.0",
+    "@google-cloud/logging-winston": "^6.0.0",
+    "@google-cloud/pubsub": "^4.0.2",
+    "@google-cloud/storage": "^7.0.1",
+    "@google-cloud/scheduler": "^4.0.0",
+    "@google-cloud/secret-manager": "^5.0.0",
+    "gaxios": "^6.1.0",
     "google-ads-api": "^13.0.1",
     "google-ads-node": "^11.0.0",
-    "google-auth-library": "^8.8.0",
-    "googleapis": "^118.0.0",
-    "winston": "^3.8.2",
+    "google-auth-library": "^9.0.0",
+    "googleapis": "^126.0.1",
+    "winston": "^3.10.0",
     "lodash": "^4.17.21"
   },
   "devDependencies": {
-    "jasmine": "^4.4.0"
+    "jasmine": "^5.1.0"
   },
   "scripts": {
     "test": "node node_modules/jasmine/bin/jasmine"

package/src/apis/ads_data_hub.js

@@ -122,17 +122,44 @@ class AdsDataHub {
   /**
    * Lists the analysis queries owned by the specified customer.
    * @see https://developers.google.com/ads-data-hub/reference/rest/v1/customers.analysisQueries/list
+   * @param {Object=} parameters The query parameter object.
    * @param {string=} customerId
    * @return {!Promise<{
    *   queries:Array<Object>,
    *   nextPageToken:string,
    * }>}
    */
-  async listQuery(customerId = this.customerId) {
-    const path = `customers/${customerId}/analysisQueries`;
+  async listQuery(parameters = {}, customerId = this.customerId) {
+    const querystring = this.getQueryString_(parameters);
+    const path = `customers/${customerId}/analysisQueries`
+      + (querystring ? `?${querystring}` : '');
     return this.sendRequestAndReturnResponse_(path);
   }
 
+  /**
+   * Starts execution on a transient analysis query. The results will be written
+   * to the specified BigQuery destination table. The returned operation name
+   * can be used to poll for query completion status.
+   * @see https://developers.google.com/ads-data-hub/reference/rest/v1/customers.analysisQueries/startTransient
+   * @param {string} queryText The content of the query.
+   * @param {Object} spec Defines the query execution parameters.
+   *     @see https://developers.google.com/ads-data-hub/reference/rest/v1/QueryExecutionSpec
+   * @param {string} destTable Destination BigQuery table for query results with
+   *     the format 'project.dataset.table_name'. If specified, the project must
+   *     be explicitly whitelisted for the customer's ADH account. If project is
+   *     not specified, uses default project for the provided customer. If
+   *     neither project nor dataset is specified, uses the default project and
+   *     dataset.
+   * @param {string=} customerId
+   * @return {!Promise<Object>} Promised operation object.
+   *     @see https://developers.google.com/ads-data-hub/reference/rest/v1/operations#Operation
+   */
+  async startTransientQuery(queryText, spec, destTable, customerId = this.customerId) {
+    const path = `customers/${customerId}/analysisQueries:startTransient`;
+    const data = { query: { queryText }, spec, destTable };
+    return this.sendRequestAndReturnResponse_(path, 'POST', data);
+  }
+
   /**
    * Creates a query and returns the unique query name in the form of
    * 'customers/[customerId]/analysisQueries/[resource_id]'.
@@ -140,12 +167,6 @@ class AdsDataHub {
    * @param {string} title The title of the query.
    * @param {string} queryText The content of the query
    * @return {!Promise<string>} Promised unique name of created query.
-   *
-   * TODO: currently here only take two properties of customers.analysisQueries
-   *   which may be not enough in future requests. If that happened, the
-   *   arguments of this function should be refactored into an object to
-   *   present an AnalysisQuery.
-   *   See https://developers.google.com/ads-data-hub/reference/rest/v1/customers.analysisQueries#resource:-analysisquery
    */
   async createQuery(title, queryText) {
     const path = `customers/${this.customerId}/analysisQueries`;
@@ -202,6 +223,19 @@ class AdsDataHub {
   async getQueryStatus(operationName) {
     return this.sendRequestAndReturnResponse_(operationName);
   }
+
+  /**
+   * Gets the query string of a parameter object.
+   * @param {Object} parameters The object of key-value pairs which will be
+   *   converted into query string format.
+   * @return string
+   * @private
+   */
+  getQueryString_(parameters = {}) {
+    return Object.keys(parameters)
+      .map((key) => key + '=' + encodeURIComponent(parameters[key]))
+      .join('&');
+  }
 }
 
 exports.AdsDataHub = AdsDataHub;