تثبيت مكتبة برامج

راحة

1. عدِّل العناصر النائبة في النموذج التالي، مثل OPERATING_ACCOUNT_PRODUCT و OPERATING_ACCOUNT_ID و AUDIENCE_ID، باستخدام قيم حسابك والوجهة.
2. استبدِل PROJECT_ID بمعرّف مشروعك على Google Cloud.

3. انسخ النموذج إلى سطر الأوامر لإرسال الطلب. لا تستخدِم نموذج شريك البيانات إلا إذا كنت تصل إلى حساب التشغيل من خلال رابط شريك. بخلاف ذلك، استخدِم نموذج المعلِن.

   المعلِن

   #!/bin/bash
   
   # Uses gcloud to get an access token. If the Application Default
   # Credentials aren't for a service account then the command that
   # specifies --scopes fails, so 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"
         },
         "productDestinationId": "AUDIENCE_ID"
       }
     ],
     "audienceMembers": [
       {
         "compositeData": {
           "userData": {
             "userIdentifiers": [
               {
                 "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
               },
               {
                 "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7"
               }
             ]
           }
         }
       },
       {
         "compositeData": {
           "userData": {
             "userIdentifiers": [
               {
                 "emailAddress": "2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3"
               },
               {
                 "emailAddress": "54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51"
               },
               {
                 "emailAddress": "e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478"
               }
             ]
           }
         }
       },
       {
         "compositeData": {
           "userData": {
             "userIdentifiers": [
               {
                 "emailAddress": "05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0"
               },
               {
                 "emailAddress": "f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5"
               }
             ]
           }
         }
       },
       {
         "compositeData": {
           "userData": {
             "userIdentifiers": [
               {
                 "emailAddress": "83a834cc5327bc4dee7c5408988040dc5813c7662611cd93b707aff72bf7d33f"
               },
               {
                 "emailAddress": "223ebda6f6889b1494551ba902d9d381daf2f642bae055888e96343d53e9f9c4"
               }
             ]
           }
         }
       }
     ],
     "consent": {
       "adUserData": "CONSENT_GRANTED",
       "adPersonalization": "CONSENT_GRANTED"
     },
     "encoding": "HEX",
     "termsOfService": {
       "customerMatchTermsOfServiceStatus": "ACCEPTED"
     },
     "validateOnly": true
   }
   EOF
   

   شريك البيانات

   #!/bin/bash
   
   # Uses gcloud to get an access token. If the Application Default
   # Credentials aren't for a service account then the command that
   # specifies --scopes fails, so 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": [
       {
         "compositeData": {
           "userData": {
             "userIdentifiers": [
               {
                 "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
               },
               {
                 "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7"
               }
             ]
           }
         }
       },
       {
         "compositeData": {
           "userData": {
             "userIdentifiers": [
               {
                 "emailAddress": "2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3"
               },
               {
                 "emailAddress": "54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51"
               },
               {
                 "emailAddress": "e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478"
               }
             ]
           }
         }
       },
       {
         "compositeData": {
           "userData": {
             "userIdentifiers": [
               {
                 "emailAddress": "05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0"
               },
               {
                 "emailAddress": "f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5"
               }
             ]
           }
         }
       },
       {
         "compositeData": {
           "userData": {
             "userIdentifiers": [
               {
                 "emailAddress": "83a834cc5327bc4dee7c5408988040dc5813c7662611cd93b707aff72bf7d33f"
               },
               {
                 "emailAddress": "223ebda6f6889b1494551ba902d9d381daf2f642bae055888e96343d53e9f9c4"
               }
             ]
           }
         }
       }
     ],
     "consent": {
       "adUserData": "CONSENT_GRANTED",
       "adPersonalization": "CONSENT_GRANTED"
     },
     "encoding": "HEX",
     "termsOfService": {
       "customerMatchTermsOfServiceStatus": "ACCEPTED"
     },
     "validateOnly": true
   }
   EOF
   

NET.

تثبيت مكتبة البرامج

اتّبِع التعليمات الواردة في دليل تثبيت مكتبة برامج ‎.NET لإضافة تبعية إلى مكتبة البرامج في مشروعك .

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

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

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

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

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

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

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

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

   dotnet run
   

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

   dotnet run -- ingest-audience-members --help
   

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

انتقال

تثبيت مكتبة البرامج

go get cloud.google.com/go/datamanager/apiv1@latest

اتّبِع التعليمات الواردة في دليل مكتبة برامج Goلمزيد من المعلومات.

جافا

تثبيت مكتبة البرامج

اتّبِع التعليمات الواردة في دليل تثبيت مكتبة برامج Java لإضافة تبعية إلى مكتبة البرامج في مشروعك .

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

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.2.0'
   

   Maven:

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

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

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

   على سبيل المثال، يشغِّل الأمر التالي عيّنة IngestAudienceMembers ويطبع بيان استخدام:

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

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

Node.js

تثبيت مكتبة البرامج

اتّبِع التعليمات الواردة في دليل تثبيت مكتبة برامج Node.js لإضافة تبعية إلى @google-ads/datamanager مكتبة البرامج في مشروعك.

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

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

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

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

3. شغِّل الأمر التالي لتثبيت التبعيات.

   npm install
   

4. انتقِل إلى دليل util.

   cd util
   

5. شغِّل الأمر التالي لتجميع مكتبة الأدوات وضغطها في ملف .tgz لاستخدامها مع npm.

   npm pack
   

   ينشئ الأمر أرشيفًا باسم google-ads-datamanager-util-0.2.0.tgz. دوِّن موقع الملف لتتمكّن من استخدامه في الخطوات التالية.

6. في مشروع Node.js، أعلِن عن تبعية على مكتبة أدوات Data Manager API من خلال إضافة إدخال dependencies للمسار الكامل واسم الملف google-ads-datamanager-util-0.2.0.tgz.

   {
      "dependencies": {
         ...
         "@google-ads/data-manager-util": "file:PATH_TO_UTILITY_LIBRARY/google-ads-datamanager-util-0.2.0.tgz",
         ...
      }
   }
   

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

7. تصفَّح عيّنات الرموز البرمجية في الدليل الفرعي samples أو على GitHub. شغِّل العيّنات باتّباع الخطوات التالية:

   1. انتقِل إلى دليل data-manager-node.

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

      على سبيل المثال، يشغِّل الأمر التالي عيّنة ingest_audience_members ويطبع بيان استخدام:

      npm run ingest-audience-members -w samples -- --help
      

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

PHP

تثبيت مكتبة البرامج

اتّبِع التعليمات الواردة في دليل تثبيت مكتبة برامج لغة PHP لإضافة الاعتمادية إلى googleads/data-manager مكتبة برامج في مشروعك.

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

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

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

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 أو على GitHub. شغِّل العيّنات باتّباع الخطوات التالية:

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

   2. شغِّل الأمر التالي لحلّ التبعيات للمكتبة:

      composer update --prefer-dist
      

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

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

Python

تثبيت مكتبة البرامج

اتّبِع التعليمات الواردة في دليل تثبيت مكتبة برامج Python لإضافة تبعية إلى google-ads-datamanager مكتبة برامج في مشروعك.

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

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

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

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

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

   pip install .
   

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

   google-ads-datamanager-util=0.2.0
   

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

6. تصفَّح عيّنات الرموز البرمجية في الدليل الفرعي samples أو على GitHub. لتشغيل العيّنات، ثبِّت التبعيات اللازمة:

   pip install .[samples]
   

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

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

Ruby

تثبيت مكتبة البرامج

اتّبِع التعليمات الواردة في دليل تثبيت مكتبة برامج Ruby لإضافة الاعتمادية إلى مكتبة البرامج في مشروعك.