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

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

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

في مشروع .NET، أعلِن عن تبعية لمكتبة الأدوات المساعدة Google.Ads.DataManager.Util.
```
dotnet add package Google.Ads.DataManager.Util --version 0.4.0
```
لتنسيق البيانات، استخدِم الأداة المساعدة UserDataFormatter في مشروع ‎ .NET.

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

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

لتشغيل النماذج:

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

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

انتقِل إلى دليل data-manager-dotnet.
انتقِل إلى الدليل 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

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

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

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