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

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

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

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

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

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

REST

اختَر نوع عملية الإعداد التي تريد اتّباعها:

  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, 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"
      },
      "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

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.

جافا

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

اتّبِع التعليمات الواردة في دليل تثبيت مكتبة برامج 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 لتشغيل نموذج من سطر الأوامر، استخدِم مهمة Gradle run.

    على سبيل المثال، يشغّل الأمر التالي 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-data-manager-util=0.2.0

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

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

    pip install .[samples]

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

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

Ruby

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

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

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

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