این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

دسترسی API را تنظیم کنید

در اینجا نحوه تنظیم دسترسی به Data Manager API با SDK یا REST آورده شده است.

پیش نیازها

قبل از اینکه بتوانید از Data API استفاده کنید، مطمئن شوید که موارد زیر را دارید:

یک پروژه Google Cloud .
یک حساب Google که دارای مجوز serviceusage.services.enable در پروژه Google Cloud شما است، یا دارای نقشی است که شامل آن مجوز است. برای مثال، roles/owner و roles/serviceusage.serviceUsageAdmin هر دو شامل مجوز serviceusage.services.enable هستند. برای بررسی مجوزهای خود، مشاهده دسترسی فعلی را ببینید.

API را فعال کنید

اگر قبلاً این کار را نکرده‌اید، با کلیک روی Enable the Data Manager API، API مدیر داده را فعال کنید یا دستورالعمل‌ها را برای انجام دستی این مرحله دنبال کنید.

اگر نتوانستید API مدیر داده را پیدا کنید یا API مدیر داده را فعال کنید ، بررسی کنید حساب Google شما پیش نیازها را برآورده کند.

احراز هویت را تنظیم کنید

علاوه بر کلیدهای API می‌توانید از هر یک از روش‌های احراز هویت در Google استفاده کنید. توصیه می کنیم نحوه انتخاب روش احراز هویت مناسب برای مورد استفاده خود را مرور کنید تا تصمیم بگیرید کدام رویکرد برای مورد استفاده شما مناسب است.

دو روش رایج احراز هویت ، حساب های کاربری و حساب های خدماتی هستند:

حساب‌های کاربری : افرادی را نشان می‌دهد که مستقیماً با APIها و سرویس‌های Google تعامل دارند.
حساب‌های سرویس : برنامه‌ها را به‌عنوان کاربران نشان می‌دهند، نه افراد. They let your apps manage authentication and authorization. به عنوان مثال، اگر یک برنامه نیاز به دسترسی به منابع Google Cloud داشته باشد.

یکپارچه‌سازی شما می‌تواند از اعتبارنامه پیش‌فرض برنامه (ADC) برای یافتن خودکار اعتبارنامه‌ها از محیط استفاده کند، بنابراین لازم نیست کد مشتری را برای احراز هویت تغییر دهید.

برای تنظیم ADC، جعل هویت حساب کاربری یا سرویس را انتخاب کنید:

در اینجا مراحل احراز هویت با اعتبار حساب کاربری وجود دارد:

تنظیمات پلتفرم Google Auth را برای پروژه خود پیکربندی کنید.
مهم: هر برنامه Google Cloud که برای به دست آوردن اعتبار کاربری برای دامنه API مدیر داده استفاده می‌شود، باید تأیید Google OAuth را انجام دهد تا از صفحه رابط کاربری تأییدنشده برای کاربران خود جلوگیری کند. تأیید Google OAuth برای حساب‌های سرویس مورد نیاز نیست.
1. صفحه برندسازی را در Google Cloud Console باز کنید.
2. پروژه خود را انتخاب کنید
3. فرم را پر کنید و روی ایجاد کلیک کنید.
از آنجایی که دامنه API مدیریت داده یک محدوده حساس است، مراحل زیر لازم است:
1. به تنظیمات دسترسی به داده برای پروژه خود بروید.
2. روی افزودن یا حذف دامنه ها کلیک کنید.
3. کادر کنار Data Manager API را در لیست محدوده‌ها علامت بزنید و روی Update کلیک کنید.
4. روی ذخیره کلیک کنید.
5. Go to Audience in the Google Cloud Console and update the Publishing status and User type . درباره این تنظیمات در مدیریت مخاطبان برنامه بیشتر بدانید.
Click Create OAuth2 client to create an OAuth2 client in the project, or follow the instructions to create a Desktop OAuth2 client.
مشتری OAuth2 ایجاد کنید
In the last step, click DOWNLOAD CLIENT CONFIGURATION and note the download location you choose.
Generate a local ADC file by running the following command. This command launches a web flow where you are prompted to login to the Google Account you're using with the API.
نام فایل JSON را که دانلود کردید جایگزین PATH_TO_CLIENT_JSON کنید.
```
gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"
```
Confirm credentials are setup correctly using the following command. در صورت موفقیت آمیز بودن، دستور یک نشانه دسترسی به کنسول چاپ می کند.
```
gcloud auth application-default print-access-token
```

برای کسب اطلاعات بیشتر درباره احراز هویت و اعتبارنامه‌های برنامه خود، به روش‌های احراز هویت در Google و نحوه عملکرد اعتبارنامه پیش‌فرض برنامه مراجعه کنید.

دسترسی به حساب عملیاتی را تنظیم کنید

Grant the email associated with your user account access to the Destination .

If using a Google Ads or data partner account, follow the instructions to add the email of the user to the account.
If using a Display & Video 360 account, follow the instructions to add the email of the user to the account.

Set up the SDK for your programming language

On your local machine, install the SDK of your choice:

استراحت

متغیرهای موجود در نمونه زیر، مانند OPERATING_ACCOUNT_PRODUCT ، OPERATING_ACCOUNT_ID ، و AUDIENCE_ID را با مقادیر حساب و مقصد خود به‌روزرسانی کنید.
Replace PROJECT_ID with the ID of your Google Cloud.

Copy the sample to the command line to send the request.

در صورتی که با استفاده از پیوند محصول ایجاد شده به operatingAccount دسترسی ندارید، ویژگی linkedAccount ورودی destinations را حذف کنید.

#!/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"
      },
      "linkedAccount": {
        "accountType": "LINKED_ACCOUNT_TYPE",
        "accountId": "LINKED_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

دات نت

Download and extract google-cloud-ads-datamanager-v1-csharp.tar.gz .
In your .NET project, declare a ProjectReference dependency on the Data Manager API library. PATH_TO_CLIENT_LIBRARY با مکانی که فهرست راهنمای google-cloud-ads-datamanager-v1-csharp از google-cloud-ads-datamanager-v1-csharp.tar.gz استخراج کردید، جایگزین کنید.
```
<ProjectReference Include="PATH_TO_CLIENT_LIBRARY\Google.Ads.DataManager.V1\Google.Ads.DataManager.V1.csproj" />
```
اختیاری Get the utility library and code samples.
1. Download and extract data-manager-dotnet.tar.gz .
2. In your .NET project, declare a ProjectReference dependency on the utility library. Replace PATH_TO_UTILITY_LIBRARY with the location where you extracted the data-manager-dotnet directory from data-manager-dotnet.tar.gz .
```
<ProjectReference Include="PATH_TO_UTILITY_LIBRARY\Google.Ads.DataManager.Util\src\Google.Ads.DataManager.Util.csproj" />
```
3. To format data, use the Formatter utility in your .NET project.
4. Browse code samples in the samples subdirectory.
  برای اجرای نمونه‌های کد، متغیر محیطی DATA_MANAGER_DOTNET_LIB روی مکانی تنظیم کنید که فهرست راهنمای google-cloud-ads-datamanager-v1-csharp از google-cloud-ads-datamanager-v1-csharp.tar.gz استخراج کرده‌اید.
```
export DATA_MANAGER_DOTNET_LIB="PATH_TO_CLIENT_LIBRARY"
```
  به دایرکتوری samples تغییر دهید و dotnet run برای دریافت لیست نمونه های موجود استفاده کنید.
```
dotnet run --framework net8.0
```
  Pass the --help argument when running a sample to print a usage statement with expected parameters.
```
dotnet run --framework net8.0 -- ingest-audience-members --help
```
  To help you get started with some sample data, use the file at samples/sampledata/audience_members_1.csv .

جاوا

google-cloud-ads-datamanager-v1-java.tar.gz را دانلود و استخراج کنید.
به فهرست راهنمای google-cloud-ads-datamanager-v1-java بروید.
Run the following command to build and publish the library to your local Maven repository for use with Maven or Gradle.
```
./gradlew install
```

In your Java project, declare a dependency on the Data Manager API library.

گریدل:

implementation 'com.google.cloud:gapic-google-cloud-ads-datamanager-v1-java:0.1.3'

ماون:

<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>gapic-google-cloud-ads-datamanager-v1-java</artifactId>
  <version>0.1.3</version>
</dependency>

اختیاری Get the utility library and code samples.
1. Clone the GitHub repository .
```
git clone https://github.com/googleads/data-manager-java.git
```
2. Navigate to the data-manager-java directory.
3. کتابخانه ابزار را در مخزن محلی Maven خود بسازید و منتشر کنید.
```
./gradlew data-manager-util:install
```
4. در پروژه جاوا خود، یک وابستگی به کتابخانه ابزار اعلام کنید.
  گریدل:
```
implementation 'com.google.api-ads:data-manager-util:0.1.0'
```
  ماون:
```
<dependency>
   <groupId>com.google.api-ads</groupId>
   <artifactId>data-manager-util</artifactId>
   <version>0.1.0</version>
</dependency>
```
5. برای قالب بندی و رمزگذاری داده ها، از ابزارهای UserDataFormatter و Encrypter در پروژه جاوا خود استفاده کنید.
6. نمونه‌های کد را در زیر شاخه data-manager-samples یا در GitHub مرور کنید. برای اجرای یک نمونه از خط فرمان، از Gradle run task استفاده کنید.
  به عنوان مثال، دستور زیر نمونه IngestAudienceMembers را اجرا می کند و یک عبارت استفاده را چاپ می کند:
```
./gradlew data-manager-samples:run \
  --args='IngestAudienceMembers --help'
```
  To help you get started with some sample data, use the file at data-manager-samples/src/main/resources/sampledata/audience_members_1.csv .

پایتون

Download ads-datamanager-v1-py.tar.gz .
Navigate to the directory of the download.
دستور زیر را برای ساخت کتابخانه و در دسترس قرار دادن آن برای پروژه های دیگر در همان محیط پایتون اجرا کنید:
```
pip install ./ads-datamanager-v1-py.tar.gz
```
در پروژه پایتون خود، یک وابستگی به کتابخانه Data Manager API اعلام کنید. برای مثال، اگر در پروژه خود از فایل requirements.txt استفاده می کنید، خط زیر را به فایل اضافه کنید:
```
google-ads-data-manager=0.1.3
```
اختیاری Get the utility library and code samples.
1. data-manager-python.tar.gz را دانلود و استخراج کنید.
2. Navigate to the data-manager-python directory.
3. برای نصب کتابخانه ابزار در محیط پایتون، دستور زیر را اجرا کنید:
```
pip install .
```
4. در پروژه پایتون خود، یک وابستگی به کتابخانه ابزار اعلام کنید. برای مثال، اگر در پروژه خود از فایل requirements.txt استفاده می کنید، خط زیر را به فایل اضافه کنید:
```
google-ads-data-manager-util=0.1.0
```
5. برای قالب بندی و رمزگذاری داده ها، از ابزارهای Formatter و Encrypter در پروژه پایتون خود استفاده کنید.
6. Browse code samples in the samples subdirectory. هنگام اجرای یک نمونه برای چاپ عبارت استفاده با پارامترهای مورد انتظار، آرگومان --help را ارسال کنید.
  برای کمک به شروع کار با برخی از داده های نمونه، از فایل در samples/sampledata/audience_members_1.csv استفاده کنید.

Node.js

ads-datamanager-v1-nodejs.tar.gz را دانلود و استخراج کنید.
به دایرکتوری ads-datamanager-v1-nodejs بروید.
دستورات زیر را برای کامپایل و بسته بندی کتابخانه در یک فایل .tgz برای استفاده با npm اجرا کنید.
```
npm install
npm pack
```
دستورات یک بایگانی به نام google-cloud-datamanager-0.1.3.tgz ایجاد می کنند.
در پروژه Node.js خود، با افزودن یک ورودی dependencies برای مسیر کامل و نام فایل فایل google-cloud-datamanager-0.1.3.tgz یک وابستگی به کتابخانه Data Manager API اعلام کنید.

PHP

google-cloud-ads-datamanager-v1-php.tar.gz را دانلود و استخراج کنید.
به دایرکتوری google-cloud-ads-datamanager-v1-php بروید.
دستور زیر را برای حل وابستگی های کتابخانه اجرا کنید:
```
composer update --prefer-dist
```
در فایل composer.json پروژه PHP خود در همان میزبان، با استفاده از مراحل زیر یک وابستگی به کتابخانه Data Manager API اعلام کنید:
1. یک بخش repositories اضافه کنید که به محل دایرکتوری google-cloud-ads-datamanager-v1-php اشاره می کند.
```
"repositories" : [
   {
      "type" : "path",
      "url" : "PATH_TO_CLIENT_LIBRARY"
   }
]
```
2. یک وابستگی به کتابخانه Data Manager API اعلام کنید.
```
"require": {
   "googleads/data-manager": "0.1.3"
}
```
(اختیاری) کتابخانه ابزار و نمونه کد را دریافت کنید.
1. data-manager-php.tar.gz را دانلود و استخراج کنید.
2. Navigate to the data-manager-php directory.
3. دستور زیر را برای حل وابستگی های کتابخانه اجرا کنید:
```
composer update --prefer-dist
```
4. در فایل composer.json پروژه PHP خود در همان هاست، با استفاده از مراحل زیر یک وابستگی به کتابخانه ابزار اعلام کنید:
  1. یک ورودی در بخش repositories اضافه کنید که به محل دایرکتوری data-manager-php اشاره می کند.
```
"repositories" : [
   {
      "type" : "path",
      "url" : "PATH_TO_UTILITY_LIBRARY"
   }
]
```
  2. Declare a dependency on the utility library.
```
"require": {
   "googleads/data-manager-util": "@dev"
}
```
  برای قالب بندی داده ها، از ابزار Formatter در پروژه PHP خود استفاده کنید.
5. نمونه کدها را در زیر شاخه samples مرور کنید. Run the samples using the following steps:
  1. Navigate to the samples directory.
  2. متغیر محیطی DATA_MANAGER_PHP_LIB را روی مسیری که کتابخانه مشتری را استخراج کردید، تنظیم کنید.
```
export DATA_MANAGER_PHP_LIB="PATH_TO_CLIENT_LIBRARY"
```
  3. دستور زیر را برای حل وابستگی های کتابخانه اجرا کنید:
```
composer update --prefer-dist
```
  4. Run the samples, passing any required arguments. هنگام اجرای یک نمونه برای چاپ عبارت استفاده با پارامترهای مورد انتظار، آرگومان --help را ارسال کنید.
  برای کمک به شروع کار با برخی از داده های نمونه، از فایل در samples/sampledata/audience_members_1.csv استفاده کنید.

مراحل بعدی

درباره ارسال اطلاعات مخاطبان بیشتر بیاموزید.
درباره ارسال رویدادها بیشتر بیاموزید.
اسناد مرجع REST یا RPC را مرور کنید.