‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

نصب کتابخانه کارخواه

در اینجا نحوه نصب و پیکربندی کتابخانه کارخواه یا REST آمده است.

پیش‌نیازها

قبل‌از نصب کتابخانه کارخواه، مراحل راه‌اندازی دسترسی به API، ازجمله پیکربندی اطلاعات اعتباری پیش‌فرض برنامه (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 خود، وابستگی به کتابخانه ابزار 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 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

نصب کتابخانه کارخواه

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

اختیاری: نصب کتابخانه ابزار

در پروژه 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

نصب کتابخانه کارخواه

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

اختیاری: نصب کتابخانه ابزار

در فایل 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

نصب کتابخانه کارخواه

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

اختیاری: نصب کتابخانه ابزار

در پروژه 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

آگهی‌دهنده

شریک داده

دات نت

نصب کتابخانه کارخواه

اختیاری: نصب کتابخانه ابزار

مرور نمونه‌های کد

رفتن

نصب کتابخانه کارخواه

جاوا

نصب کتابخانه کارخواه

اختیاری: نصب کتابخانه ابزار

مرور نمونه‌های کد

Node.js

نصب کتابخانه کارخواه

اختیاری: نصب کتابخانه ابزار

مرور نمونه‌های کد

PHP

نصب کتابخانه کارخواه

اختیاری: نصب کتابخانه ابزار

مرور نمونه‌های کد

Python

نصب کتابخانه کارخواه

اختیاری: نصب کتابخانه ابزار

مرور نمونه‌های کد

Ruby

نصب کتابخانه کارخواه

مراحل بعدی

نصب کتابخانه کارخواه