إعداد إذن الوصول إلى واجهة برمجة التطبيقات

انسخ العيّنة إلى سطر الأوامر لإرسال الطلب.

أزِل السمة linkedAccount من الإدخال في destinations إذا لم تكن تصل إلى operatingAccount باستخدام رابط منتج ثابت.

#!/bin/bash

# Uses gcloud to get an access token. If the Application Default
# Credentials aren't for a service account, the command that specifies
# --scopes fails. This sample falls back to the command without the
# --scopes argument.
DATA_MANAGER_ACCESS_TOKEN="$(gcloud auth application-default print-access-token --scopes=https://www.googleapis.com/auth/datamanager || \
  gcloud auth application-default print-access-token)"

# Fetches and prints the scope information for the access token. If you
# get scope-related errors when you send the request in the next step,
# verify that this output includes the Data Manager API scope:
#   https://www.googleapis.com/auth/datamanager
curl https://www.googleapis.com/oauth2/v1/tokeninfo?access_token="${DATA_MANAGER_ACCESS_TOKEN}"

# Sends the request.
curl -X POST "https://datamanager.googleapis.com/v1/audienceMembers:ingest" \
  --header "Authorization: Bearer ${DATA_MANAGER_ACCESS_TOKEN}" \
  --header "x-goog-user-project: PROJECT_ID" \
  --header "Content-Type: application/json" \
  --data @- <<EOF
{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "OPERATING_ACCOUNT_TYPE",
        "accountId": "OPERATING_ACCOUNT_ID"
      },
      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_TYPE",
        "accountId": "LOGIN_ACCOUNT_ID"
      },
      "linkedAccount": {
        "accountType": "LINKED_ACCOUNT_TYPE",
        "accountId": "LINKED_ACCOUNT_ID"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ],
  "audienceMembers": [
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
          },
          {
            "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3"
          },
          {
            "emailAddress": "54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51"
          },
          {
            "emailAddress": "e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0"
          },
          {
            "emailAddress": "f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "83a834cc5327bc4dee7c5408988040dc5813c7662611cd93b707aff72bf7d33f"
          },
          {
            "emailAddress": "223ebda6f6889b1494551ba902d9d381daf2f642bae055888e96343d53e9f9c4"
          }
        ]
      }
    }
  ],
  "consent": {
    "adUserData": "CONSENT_GRANTED",
    "adPersonalization": "CONSENT_GRANTED"
  },
  "encoding": "HEX",
  "termsOfService": {
    "customerMatchTermsOfServiceStatus": "ACCEPTED"
  },
  "validateOnly": true
}
EOF

نزِّل الملف google-cloud-ads-datamanager-v1-csharp.tar.gz واستخرِجه.

في مشروع ‎ .NET، حدِّد تبعية ProjectReference لمكتبة Data Manager API. استبدِل PATH_TO_CLIENT_LIBRARY بالموقع الجغرافي الذي استخرجت منه الدليل google-cloud-ads-datamanager-v1-csharp من google-cloud-ads-datamanager-v1-csharp.tar.gz.

<ProjectReference Include="PATH_TO_CLIENT_LIBRARY\Google.Ads.DataManager.V1\Google.Ads.DataManager.V1.csproj" />

Optional. الحصول على مكتبة الأدوات وعيّنات الرموز البرمجية

1. نزِّل الملف data-manager-dotnet.tar.gz واستخرِجه.

2. في مشروع .NET، حدِّد تبعية ProjectReference لمكتبة الأدوات المساعدة. استبدِل PATH_TO_UTILITY_LIBRARY بالموقع الجغرافي الذي استخرجت منه الدليل data-manager-dotnet من data-manager-dotnet.tar.gz.

   <ProjectReference Include="PATH_TO_UTILITY_LIBRARY\Google.Ads.DataManager.Util\src\Google.Ads.DataManager.Util.csproj" />
   

3. لتنسيق البيانات، استخدِم الأداة المساعدة Formatter في مشروع .NET.

4. تصفَّح عيّنات الرموز البرمجية في الدليل الفرعي samples.

   لتشغيل نماذج الرموز، اضبط متغيّر بيئة DATA_MANAGER_DOTNET_LIB على الموقع الجغرافي الذي استخرجت منه الدليل google-cloud-ads-datamanager-v1-csharp من google-cloud-ads-datamanager-v1-csharp.tar.gz.

   export DATA_MANAGER_DOTNET_LIB="PATH_TO_CLIENT_LIBRARY"
   

   انتقِل إلى الدليل samples واستخدِم dotnet run للحصول على قائمة بالعينات المتاحة.

   dotnet run --framework net8.0
   

   مرِّر الوسيطة --help عند تشغيل عيّنة لطباعة بيان الاستخدام مع المَعلمات المتوقّعة.

   dotnet run --framework net8.0 -- ingest-audience-members --help
   

   لمساعدتك في البدء ببعض البيانات النموذجية، استخدِم الملف على samples/sampledata/audience_members_1.csv.

نفِّذ الأمر التالي لإنشاء المكتبة ونشرها في مستودع Maven المحلي لاستخدامها مع Maven أو Gradle.

./gradlew install

في مشروع Java، حدِّد اعتمادية على مكتبة Data Manager API.

Gradle:

implementation 'com.google.cloud:gapic-google-cloud-ads-datamanager-v1-java:0.1.3'

‫Maven:

<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>gapic-google-cloud-ads-datamanager-v1-java</artifactId>
  <version>0.1.3</version>
</dependency>

Optional. الحصول على مكتبة الأدوات وعيّنات الرموز البرمجية

1. استنسِخ مستودع GitHub.

   git clone https://github.com/googleads/data-manager-java.git
   

2. انتقِل إلى دليل data-manager-java.

3. أنشئ مكتبة الأدوات المساعدة وانشرها في مستودع Maven المحلي.

   ./gradlew data-manager-util:install
   

4. في مشروع Java، حدِّد عنصرًا تابعًا لمكتبة الأدوات المساعدة.

   Gradle:

   implementation 'com.google.api-ads:data-manager-util:0.1.0'
   

   ‫Maven:

   <dependency>
      <groupId>com.google.api-ads</groupId>
      <artifactId>data-manager-util</artifactId>
      <version>0.1.0</version>
   </dependency>
   

5. لتنسيق البيانات وتشفيرها، استخدِم الأداتَين UserDataFormatter وEncrypter في مشروع Java.

6. تصفُّح عيّنات الرموز في الدليل الفرعي data-manager-samples أو على GitHub لتشغيل نموذج من سطر الأوامر، استخدِم مهمة Gradle run.

   على سبيل المثال، ينفّذ الأمر التالي IngestAudienceMembers نموذجًا ويطبع بيانًا عن الاستخدام:

   ./gradlew data-manager-samples:run \
     --args='IngestAudienceMembers --help'
   

   لمساعدتك في البدء ببعض البيانات النموذجية، استخدِم الملف على data-manager-samples/src/main/resources/sampledata/audience_members_1.csv.

نفِّذ الأمر التالي لإنشاء المكتبة وإتاحتها للمشاريع الأخرى في بيئة Python نفسها:

pip install ./ads-datamanager-v1-py.tar.gz

في مشروع Python، حدِّد تبعية لمكتبة Data Manager API. على سبيل المثال، إذا كنت تستخدم ملف requirements.txt في مشروعك، أضِف السطر التالي إلى الملف:

google-ads-data-manager=0.1.3

Optional. الحصول على مكتبة الأدوات وعيّنات الرموز البرمجية

1. نزِّل الملف data-manager-python.tar.gz واستخرِجه.
2. انتقِل إلى دليل data-manager-python.

3. لتثبيت مكتبة الأدوات المساعدة في بيئة Python، شغِّل الأمر التالي:

   pip install .
   

4. في مشروع Python، حدِّد عنصرًا تابعًا لمكتبة الأدوات المساعدة. على سبيل المثال، إذا كنت تستخدم ملف requirements.txt في مشروعك، أضِف السطر التالي إلى الملف:

   google-ads-data-manager-util=0.1.0
   

5. لتنسيق البيانات وتشفيرها، استخدِم الأداتَين Formatter وEncrypter في مشروع Python.

6. تصفَّح عيّنات الرموز البرمجية في الدليل الفرعي samples. مرِّر الوسيطة --help عند تشغيل نموذج لطباعة بيان الاستخدام مع المَعلمات المتوقّعة.

   لمساعدتك في البدء ببعض البيانات النموذجية، استخدِم الملف على samples/sampledata/audience_members_1.csv.

نفِّذ الأوامر التالية لتجميع المكتبة وحزمها في ملف .tgz لاستخدامه مع npm.

npm install
npm pack

تنشئ الأوامر أرشيفًا باسم google-cloud-datamanager-0.1.3.tgz.

في مشروع Node.js، حدِّد تبعية مكتبة Data Manager API من خلال إضافة إدخال dependencies للمسار الكامل واسم الملف للملف google-cloud-datamanager-0.1.3.tgz.

نفِّذ الأمر التالي لحلّ التبعيات الخاصة بالمكتبة:

composer update --prefer-dist

في ملف composer.json الخاص بمشروع PHP على المضيف نفسه، حدِّد اعتمادًا على مكتبة Data Manager API باتّباع الخطوات التالية:

1. أضِف قسم repositories يشير إلى موقع الدليل google-cloud-ads-datamanager-v1-php.

   "repositories" : [
      {
         "type" : "path",
         "url" : "PATH_TO_CLIENT_LIBRARY"
      }
   ]
   

2. حدِّد اعتمادية على مكتبة Data Manager API.

   "require": {
      "googleads/data-manager": "0.1.3"
   }
   

(اختياري) الحصول على مكتبة الأدوات المساعدة وعيّنات الرموز البرمجية

1. نزِّل الملف data-manager-php.tar.gz واستخرِجه.
2. انتقِل إلى دليل data-manager-php.

3. نفِّذ الأمر التالي لحلّ التبعيات الخاصة بالمكتبة:

   composer update --prefer-dist
   

4. في ملف composer.json لمشروع PHP على المضيف نفسه، حدِّد اعتمادية على مكتبة الأدوات المساعدة باتّباع الخطوات التالية:

   1. أضِف إدخالاً في القسم repositories يشير إلى موقع الدليل data-manager-php.

      "repositories" : [
         {
            "type" : "path",
            "url" : "PATH_TO_UTILITY_LIBRARY"
         }
      ]
      

   2. عليك تعريف عنصر تابع لمكتبة الأدوات المساعدة.

      "require": {
         "googleads/data-manager-util": "@dev"
      }
      

   لتنسيق البيانات، استخدِم الأداة المساعدة Formatter في مشروع PHP.

5. تصفَّح عيّنات الرموز البرمجية في الدليل الفرعي samples. نفِّذ النماذج باتّباع الخطوات التالية:

   1. انتقِل إلى دليل samples.

   2. اضبط متغيّر البيئة DATA_MANAGER_PHP_LIB على المسار الذي استخرجت منه مكتبة البرامج.

      export DATA_MANAGER_PHP_LIB="PATH_TO_CLIENT_LIBRARY"
      

   3. نفِّذ الأمر التالي لحلّ التبعيات الخاصة بالمكتبة:

      composer update --prefer-dist
      

   4. نفِّذ النماذج مع إدخال أي وسيطات مطلوبة. مرِّر الوسيطة --help عند تشغيل نموذج لطباعة بيان الاستخدام مع المَعلمات المتوقّعة.

   لمساعدتك في البدء ببعض البيانات النموذجية، استخدِم الملف على samples/sampledata/audience_members_1.csv.