تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

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

في ما يلي كيفية تثبيت مكتبة برامج أو REST وإعدادهما.

المتطلبات الأساسية

قبل تثبيت مكتبة برامج، عليك إكمال الخطوات الواردة في إعداد إذن الوصول إلى واجهة برمجة التطبيقات، بما في ذلك ضبط بيانات الاعتماد التلقائية للتطبيق (ADC).

خطوات التثبيت

على جهازك، ثبِّت مكتبة البرامج التي تختارها:

REST

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

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

المعلِن

#!/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 لإضافة الاعتمادية إلى مكتبة البرامج في مشروعك.

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

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

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

في مشروع .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" />
```
لتنسيق البيانات، استخدِم الأداة المساعدة Formatter في مشروع .NET.
تصفُّح عيّنات التعليمات البرمجية في الدليل الفرعي samples أو على GitHub

انتقِل إلى الدليل samples واستخدِم dotnet run للحصول على قائمة بالعينات المتاحة.
```
dotnet run
```
مرِّر الوسيطة --help عند تشغيل عيّنة لطباعة بيان الاستخدام مع المَعلمات المتوقّعة.
```
dotnet run -- ingest-audience-members --help
```
لمساعدتك في البدء ببعض البيانات النموذجية، استخدِم الملفات في samples/sampledata.

Go

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

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

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

جافا

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

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

اختياري: تثبيت مكتبة الأدوات المساعدة

بالإضافة إلى مكتبة العميل، يمكنك تثبيت مكتبة الأدوات المساعدة للمساعدة في تنفيذ المهام الشائعة، مثل تنسيق البيانات وتشفيرها من أجل استيعابها.

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

Gradle:

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

‫Maven:

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

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

تصفُّح عيّنات التعليمات البرمجية

تصفُّح عيّنات التعليمات البرمجية في الدليل الفرعي data-manager-samples أو على GitHub

لتشغيل العيّنات، اتّبِع الخطوات التالية:

استنسِخ مستودع GitHub في العلامة v0.4.0:

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

انتقِل إلى دليل data-manager-java.
يمكنك تشغيل العيّنات من سطر الأوامر باستخدام مهمة Gradle run، مع تمرير أي وسيطات مطلوبة. مرِّر الوسيطة --help عند تشغيل نموذج لطباعة بيان استخدام مع المَعلمات المتوقّعة.

على سبيل المثال، يشغّل الأمر التالي نموذج IngestAudienceMembers ويعرض بيانًا عن الاستخدام:
```
./gradlew data-manager-samples:run \
   --args='IngestAudienceMembers --help'
```

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

Node.js

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

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

اختياري: تثبيت مكتبة الأدوات المساعدة

بالإضافة إلى مكتبة العميل، يمكنك تثبيت مكتبة الأدوات المساعدة للمساعدة في تنفيذ المهام الشائعة، مثل تنسيق البيانات لإدخالها.

في مشروع Node.js، حدِّد تبعية لمكتبة الأداة المساعدة @google-ads/datamanager-util:
```
npm install @google-ads/datamanager-util
```
لتنسيق البيانات، استخدِم الأداة المساعدة UserDataFormatter في مشروع Node.js.

تصفُّح عيّنات التعليمات البرمجية

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

لتشغيل العيّنات، اتّبِع الخطوات التالية:

استنسِخ مستودع GitHub في العلامة v0.4.1:

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

انتقِل إلى دليل data-manager-node.
ثبِّت التبعيات لتشغيل النماذج:
```
npm install
```
نفِّذ النماذج مع إدخال أي وسيطات مطلوبة. مرِّر الوسيطة --help عند تشغيل عيّنة لطباعة بيان الاستخدام مع المَعلمات المتوقّعة.

على سبيل المثال، يشغّل الأمر التالي عيّنة ingest-audience-members ويطبع بيانًا عن الاستخدام:
```
npm run ingest-audience-members -w samples -- --help
```

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

PHP

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

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

اختياري: تثبيت مكتبة الأدوات المساعدة

في ملف composer.json الخاص بمشروع PHP على المضيف نفسه، عرِّف اعتمادًا على مكتبة الأدوات المساعدة:
```
composer require googleads/data-manager-util
```
لتنسيق البيانات، استخدِم الأداة المساعدة Formatter في مشروع PHP.

تصفُّح عيّنات التعليمات البرمجية

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

لتشغيل العيّنات، اتّبِع الخطوات التالية:

استنسِخ مستودع GitHub في العلامة v0.4.0:

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

انتقِل إلى دليل data-manager-php/samples.
ثبِّت التبعيات لتشغيل النماذج:
```
composer install
```
نفِّذ النماذج مع إدخال أي وسيطات مطلوبة. مرِّر الوسيطة --help عند تشغيل عيّنة لطباعة بيان الاستخدام مع المَعلمات المتوقّعة.

على سبيل المثال، يشغّل الأمر التالي عيّنة ingest_audience_members ويطبع بيانًا عن الاستخدام:
```
php audiences/ingest_audience_members.php --help
```

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

Python

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

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

اختياري: تثبيت مكتبة الأدوات المساعدة

في مشروع Python، حدِّد عنصرًا تابعًا لمكتبة الأدوات المساعدة google-ads-datamanager-util.

على سبيل المثال، إذا كنت تستخدم ملف requirements.txt في مشروعك، أضِف السطر التالي إلى الملف:
```
google-ads-datamanager-util==0.4.0
```
أو يمكنك تثبيت مكتبة الأدوات المساعدة مباشرةً:
```
pip install google-ads-datamanager-util==0.4.0
```
لتنسيق البيانات وتشفيرها، استخدِم الأداتَين Formatter وEncrypter في مشروع Python.

تصفُّح عيّنات التعليمات البرمجية

استنسِخ مستودع GitHub في العلامة v0.4.0:

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

انتقِل إلى دليل data-manager-python.
ثبِّت التبعيات لتشغيل النماذج:
```
pip install -r samples/requirements.txt
```
نفِّذ النماذج مع إدخال أي وسيطات مطلوبة. مرِّر الوسيطة --help عند تشغيل عيّنة لطباعة بيان الاستخدام مع المَعلمات المتوقّعة.

على سبيل المثال، يشغّل الأمر التالي نموذج ingest_audience_members ويعرض بيانًا عن الاستخدام:
```
python3 samples/audiences/ingest_audience_members.py --help
```

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

Ruby

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

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

الخطوات التالية

مزيد من المعلومات عن إرسال بيانات الجمهور
مزيد من المعلومات عن إرسال الأحداث
تصفَّح المستندات المرجعية REST أو RPC.

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

مهارات الوكيل

تثبيت مكتبة برامج تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

المتطلبات الأساسية

خطوات التثبيت

REST

المعلِن

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

NET.

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

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

Go

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

جافا

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

اختياري: تثبيت مكتبة الأدوات المساعدة

تصفُّح عيّنات التعليمات البرمجية

Node.js

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

اختياري: تثبيت مكتبة الأدوات المساعدة

تصفُّح عيّنات التعليمات البرمجية

PHP

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

اختياري: تثبيت مكتبة الأدوات المساعدة

تصفُّح عيّنات التعليمات البرمجية

Python

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

اختياري: تثبيت مكتبة الأدوات المساعدة

تصفُّح عيّنات التعليمات البرمجية

Ruby

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

الخطوات التالية

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