@google-cloud/nodejs-common 1.0.2 → 1.0.3-alpha

package/bin/install_functions.sh

@@ -1910,3 +1910,27 @@ join_string_array() {
   shift
   printf %s "$first" "${@/#/$separator}"
 }
+
+#######################################
+# Creates or updates the BigQuery view.
+# Globals:
+#  GCP_PROJECT
+#  DATASET
+# Arguments:
+#  The name of view.
+#  The query of view.
+#######################################
+create_or_update_view() {
+  local viewName viewQuery
+  viewName="${1}"
+  viewQuery="${2}"
+  local action="mk"
+  if [[ $(check_existence_in_bigquery "${DATASET}.${viewName}") -eq 0 ]]; then
+    action="update"
+  fi
+  bq "${action}" \
+    --use_legacy_sql=false \
+    --view "${viewQuery}" \
+    --project_id ${GCP_PROJECT} \
+    "${DATASET}.${viewName}"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@google-cloud/nodejs-common",
-  "version": "1.0.2",
+  "version": "1.0.3-alpha",
   "description": "A NodeJs common library for solutions based on Cloud Functions",
   "author": "Google Inc.",
   "license": "Apache-2.0",

package/src/apis/google_ads.js

@@ -80,6 +80,13 @@ const IDENTIFIERS = [
   'address_info',
 ];
 
+/**
+ * Maximum number of user identifiers in single UserData.
+ * @see https://ads-developers.googleblog.com/2021/10/userdata-enforcement-in-google-ads-api.html
+ * @type {number}
+ */
+const MAX_IDENTIFIERS_PER_USER = 20;
+
 /**
  * Configuration for uploading click conversions for Google Ads, includes:
  * gclid, conversion_action, conversion_date_time, conversion_value,
@@ -139,15 +146,11 @@ let CustomerMatchConfig;
  * hashed_email, hashed_phone_number, mobile_id, third_party_user_id or address_info
  * @see https://developers.google.com/google-ads/api/reference/rpc/latest/UserIdentifier
  * @typedef {{
- *   hashed_email: string,
- * }|{
- *   hashed_phone_number: string,
- * }|{
- *   mobile_id: string,
- * }|{
- *   third_party_user_id: string,
- * }|{
- *   address_info: GoogleAdsApi.OfflineUserAddressInfo,
+ *   hashed_email: (string|Array<string>|undefined),
+ *   hashed_phone_number: (string|Array<string>|undefined),
+ *   mobile_id: (string|Array<string>|undefined),
+ *   third_party_user_id: (string|Array<string>|undefined),
+ *   address_info: (GoogleAdsApi.OfflineUserAddressInfo|undefined),
  * }}
  */
 let CustomerMatchRecord;
@@ -530,18 +533,17 @@ class GoogleAds {
     const customerId = customerMatchConfig.customer_id.replace(/-/g, '');
     const loginCustomerId = customerMatchConfig.login_customer_id.replace(/-/g,
         '');
-    const userListType = customerMatchConfig.list_type;
     const userListId = customerMatchConfig.list_id;
     const operation = customerMatchConfig.operation;
 
     const customer = this.getGoogleAdsApiCustomer_(loginCustomerId, customerId);
     const operationsList = this.buildOperationsList_(operation,
-        customerMatchRecords, userListType);
+        customerMatchRecords);
     const metadata = this.buildCustomerMatchUserListMetadata_(customerId,
         userListId);
     const request = UploadUserDataRequest.create({
       customer_id: customerId,
-      operations: [operationsList],
+      operations: operationsList,
       customer_match_user_list_metadata: metadata,
     });
     const response = await customer.userData.uploadUserData(request);
@@ -556,18 +558,36 @@ class GoogleAds {
    * @see https://developers.google.com/google-ads/api/reference/rpc/latest/UserDataOperation
    * @param {string} operationType either 'create' or 'remove'
    * @param {Array<CustomerMatchRecord>} customerMatchRecords userIds
-   * @param {string} userListType One of the following hashed_email, hashed_phone_number,
-   *     mobile_id, third_party_user_id or address_info
    * @return {Array<UserDataOperation>}
    * @private
    */
-  buildOperationsList_(operationType, customerMatchRecords, userListType) {
-    const userIdentifiers = customerMatchRecords.map((customerMatchRecord) => {
-      return UserIdentifier.create(
-          {[userListType]: customerMatchRecord[userListType]});
+  buildOperationsList_(operationType, customerMatchRecords) {
+    return customerMatchRecords.map((customerMatchRecord) => {
+      const userIdentifiers = [];
+      IDENTIFIERS.forEach((idType) => {
+        const idValue = customerMatchRecord[idType];
+        if (idValue) {
+          if (Array.isArray(idValue)) {
+            idValue.forEach((user) => {
+              userIdentifiers.push(UserIdentifier.create({[idType]: user}));
+            });
+          } else {
+            userIdentifiers.push(UserIdentifier.create({[idType]: idValue}));
+          }
+        }
+      });
+      let userData;
+      if (userIdentifiers.length <= MAX_IDENTIFIERS_PER_USER) {
+        userData = UserData.create({user_identifiers: userIdentifiers});
+      } else {
+        this.logger.warn(
+            `Too many user identifiers, will only send ${MAX_IDENTIFIERS_PER_USER}:`,
+            JSON.stringify(customerMatchRecord));
+        userData = UserData.create({user_identifiers: userIdentifiers}.slice(0,
+            MAX_IDENTIFIERS_PER_USER));
+      }
+      return UserDataOperation.create({[operationType]: userData});
     });
-    const userData = UserData.create({user_identifiers: userIdentifiers});
-    return UserDataOperation.create({[operationType]: userData});
   }
 
   /**

package/src/apis/index.js

@@ -88,7 +88,7 @@ exports.bigquery = require('./bigquery.js');
  * APIs integration class for Google Ads.
  * @const {{
  *   GoogleAds:!GoogleAds,
- *   ClickConversionConfig:!ClickConversionConfig,
+ *   ConversionConfig:!ConversionConfig,
  *   CustomerMatchConfig: !CustomerMatchConfig,
  *   CustomerMatchRecord: !CustomerMatchRecord,
  *   ReportQueryConfig:!ReportQueryConfig,