یک کتابخانه مشتری نصب کنید

در اینجا نحوه نصب و پیکربندی کتابخانه کلاینت یا REST را توضیح می‌دهیم.

پیش‌نیازها

قبل از نصب کتابخانه کلاینت، مراحل موجود در بخش «تنظیم دسترسی API» از جمله پیکربندی «اعتبارنامه‌های پیش‌فرض برنامه» (ADC) را تکمیل کنید.

نصب کتابخانه

روی دستگاه محلی خود، کتابخانه کلاینت مورد نظر خود را نصب کنید:

استراحت

نوع فرآیند راه‌اندازی مورد نظر خود را انتخاب کنید:

  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

{ "مقصدها": [ { "operatingAccount": { "accountType": "نوع حساب OPERATING_ACCOUNT_TYPE "، "شناسه حساب کاربری": " OPERATING_ACCOUNT_ID " }, "loginAccount": { "نوع حساب کاربری": " LOGIN_ACCOUNT_TYPE حساب کاربری"، "شناسه حساب کاربری": " LOGIN_ACCOUNT_ID " }, " AUDIENCE_ID مقصد محصول": "شناسه مخاطب" } ], "اعضای مخاطب": [ { "userData": { "شناسه‌های کاربر": [ { "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3" }, { "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7" } ] } }, { "userData": { "userIdentifiers": [{"email" "2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3" }, { "emailAddress": "54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51" }, { "emailAddress": "e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478" } ] } }, { "userData": { "userIdentifiers": [ { "emailAddress" "05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0" }, { "emailAddress": "f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5" } ] } }, { "userData": { "شناسه‌های کاربر": [ { "آدرس ایمیل": "83a834cc5327bc4dee7c5408988040dc5813c7662611cd93b707aff72bf7d33f" }, { "آدرس ایمیل": "223ebda6f6889b1494551ba902d9d381daf2f642bae055888e96343d53e9f9c4" } ] } } ], "رضایت": { "adUserData": "CONSENT_GRANTED", "adPersonalization": "CONSENT_GRANTED" }, "رمزگذاری": "HEX", "termsOfService": { "customerMatchTermsOfServiceStatus": "ACCEPTED" }, "فقط اعتبارسنجی": true }

EOF

دات نت

کتابخانه کلاینت را نصب کنید

برای افزودن یک وابستگی به کتابخانه کلاینت در پروژه خود، دستورالعمل‌های موجود در راهنمای نصب کتابخانه کلاینت .NET را دنبال کنید.

اختیاری: کتابخانه ابزار و نمونه‌های کد را دریافت کنید.

  1. مخزن گیت‌هاب را کلون کنید.

    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 استفاده کنید.

جاوا

کتابخانه کلاینت را نصب کنید

برای افزودن وابستگی به کتابخانه کلاینت در پروژه خود، دستورالعمل‌های موجود در راهنمای نصب کتابخانه کلاینت جاوا را دنبال کنید.

اختیاری: کتابخانه ابزار و نمونه‌های کد را دریافت کنید.

  1. مخزن گیت‌هاب را کلون کنید.

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

  2. به پوشه data-manager-java بروید.

  3. کتابخانه‌ی کاربردی را ساخته و در مخزن محلی Maven خود منتشر کنید.

    ./gradlew data-manager-util:install

  4. در پروژه جاوای خود، یک وابستگی به کتابخانه‌ی کاربردی تعریف کنید.

    درجه بندی:

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

    ماون:

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

  5. برای قالب‌بندی و رمزگذاری داده‌ها، از ابزارهای UserDataFormatter و Encrypter در پروژه جاوا خود استفاده کنید.

  6. نمونه‌های کد را در زیرشاخه data-manager-samples یا در GitHub مرور کنید. برای اجرای یک نمونه از خط فرمان، از دستور Gradle run task استفاده کنید.

    برای مثال، دستور زیر نمونه‌ی IngestAudienceMembers را اجرا می‌کند و یک عبارت استفاده چاپ می‌کند: 

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

    برای کمک به شروع کار با برخی از داده‌های نمونه، از فایل موجود در data-manager-samples/src/main/resources/sampledata/audience_members_1.csv استفاده کنید.

نود جی اس

کتابخانه کلاینت را نصب کنید

برای افزودن وابستگی به کتابخانه کلاینت @google-ads/datamanager در پروژه خود، دستورالعمل‌های موجود در راهنمای نصب کتابخانه کلاینت Node.js را دنبال کنید.

اختیاری: کتابخانه ابزار و نمونه‌های کد را دریافت کنید.

  1. مخزن گیت‌هاب را کلون کنید. 

    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 خود، با اضافه کردن یک ورودی dependencies برای مسیر کامل و نام فایل google-ads-datamanager-util-0.2.0.tgz ، یک وابستگی به کتابخانه ابزار Data Manager API اعلام کنید. 

    {
   "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 استفاده کنید.

پی اچ پی

کتابخانه کلاینت را نصب کنید

برای افزودن وابستگی به کتابخانه کلاینت googleads/data-manager در پروژه خود، دستورالعمل‌های موجود در راهنمای نصب کتابخانه کلاینت PHP را دنبال کنید.

اختیاری: کتابخانه ابزار و نمونه‌های کد را دریافت کنید.

  1. مخزن گیت‌هاب را کلون کنید. 

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

  2. به پوشه data-manager-php بروید.

  3. برای حل وابستگی‌های کتابخانه، دستور زیر را اجرا کنید: 

    composer update --prefer-dist

  4. در فایل composer.json پروژه PHP خود که روی همان میزبان قرار دارد، با استفاده از مراحل زیر، یک وابستگی به کتابخانه‌ی کاربردی (utility library) تعریف کنید:

    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 استفاده کنید.

پایتون

کتابخانه کلاینت را نصب کنید

برای افزودن وابستگی به کتابخانه کلاینت google-ads-datamanager در پروژه خود، دستورالعمل‌های موجود در راهنمای نصب کتابخانه کلاینت پایتون را دنبال کنید.

اختیاری: کتابخانه ابزار و نمونه‌های کد را دریافت کنید.

  1. مخزن گیت‌هاب را کلون کنید. 

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

  2. به پوشه data-manager-python بروید.

  3. برای نصب کتابخانه‌ی کاربردی در محیط پایتون خود، دستور زیر را اجرا کنید: 

    pip install .

  4. در پروژه پایتون خود، یک وابستگی به کتابخانه ابزار تعریف کنید. برای مثال، اگر از فایل requirements.txt در پروژه خود استفاده می‌کنید، خط زیر را به فایل اضافه کنید: 

    google-ads-data-manager-util=0.2.0

  5. برای قالب‌بندی و رمزگذاری داده‌ها، از ابزارهای Formatter و Encrypter در پروژه پایتون خود استفاده کنید.

  6. نمونه‌های کد را در زیرشاخه samples یا در GitHub مرور کنید. برای اجرای نمونه‌ها، وابستگی‌های لازم را نصب کنید: 

    pip install .[samples]

    هنگام اجرای یک نمونه، آرگومان --help را برای چاپ یک عبارت استفاده با پارامترهای مورد انتظار ارسال کنید.

    برای کمک به شروع کار با برخی از داده‌های نمونه، از فایل samples/sampledata/audience_members_1.csv استفاده کنید.

روبی

کتابخانه کلاینت را نصب کنید

برای افزودن وابستگی به کتابخانه کلاینت در پروژه خود، دستورالعمل‌های موجود در راهنمای نصب کتابخانه کلاینت روبی را دنبال کنید.

مراحل بعدی

قبلی
دسترسی API را تنظیم کنید