گردش کار حساب خدمات

این راهنما نحوه دسترسی به API گوگل ادز با حساب‌های سرویس را مورد بحث قرار می‌دهد.

یک حساب کاربری سرویس ، حسابی است که به جای یک کاربر نهایی، متعلق به برنامه شماست. حساب‌های کاربری سرویس از جریان OAuth 2.0 استفاده می‌کنند که نیازی به مجوز انسانی ندارد و در عوض از یک فایل کلیدی استفاده می‌کنند که فقط برنامه شما می‌تواند به آن دسترسی داشته باشد.

استفاده از حساب‌های کاربری سرویس دو مزیت کلیدی ارائه می‌دهد:

• مجوز دسترسی API گوگل ادز به حساب‌های گوگل ادز به عنوان یک مرحله پیکربندی انجام می‌شود و از ویژگی‌های مجوز و مدیریت حساب ارائه شده توسط رابط کاربری گوگل ادز بهره می‌برد. این امر با عدم نیاز به ساخت جریان‌های OAuth 2.0 و مقابله با پیچیدگی‌هایی که شامل تعامل با کاربر، ذخیره اعتبارنامه‌های کاربر و غیره می‌شود، در تلاش توسعه‌دهندگان صرفه‌جویی می‌کند.

• مجوز دسترسی به حساب‌های گوگل ادز به اعتبارنامه‌های کاربران وابسته نیست، که این موضوع می‌تواند در مواردی مفید باشد که انتظار می‌رود چنین مجوزی حتی در صورت ترک تیم یا شرکت توسط کارمندی که در ابتدا اجازه دسترسی را داده است، ادامه یابد.

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

1. با ایجاد یک حساب کاربری سرویس و اعتبارنامه‌ها شروع کنید.

   کلید حساب سرویس را با فرمت JSON دانلود کنید و شناسه و ایمیل حساب سرویس را یادداشت کنید.

2. به عنوان مدیر وارد حساب گوگل ادز خود شوید. به بخش مدیریت > دسترسی و امنیت بروید.

3. روی دکمه + در زیر تب کاربران کلیک کنید.

   

4. ایمیل حساب کاربری سرویس را در کادر ورودی ایمیل تایپ کنید. سطح دسترسی مناسب به حساب را انتخاب کرده و روی دکمه افزودن حساب کلیک کنید.

   

5. به حساب کاربری سرویس دسترسی داده می‌شود.

   

6. [اختیاری] به طور پیش‌فرض، شما نمی‌توانید به یک حساب کاربری سرویس، دسترسی مدیر بدهید. اگر فراخوانی‌های API شما نیاز به دسترسی مدیر دارد، می‌توانید دسترسی را به شرح زیر ارتقا دهید.

   • روی فلش کشویی کنار سطح دسترسی حساب سرویس در ستون سطح دسترسی کلیک کنید.
   • از لیست کشویی، گزینه مدیریت (Admin) را انتخاب کنید.

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

برای دستورالعمل‌های مربوط به نحوه پیکربندی کتابخانه کلاینت، برگه مربوط به زبان برنامه‌نویسی خود را انتخاب کنید.

api.googleads.serviceAccountSecretsPath=JSON_KEY_FILE_PATH

GoogleAdsConfig config = new GoogleAdsConfig()
{
    OAuth2Mode = OAuth2Flow.SERVICE_ACCOUNT,
    OAuth2SecretsJsonPath = "PATH_TO_JSON_SECRETS_PATH",
    ...
};
GoogleAdsClient client = new GoogleAdsClient(config);

json_key_file_path: JSON_KEY_FILE_PATH

export GOOGLE_ADS_JSON_KEY_FILE_PATH=JSON_KEY_FILE_PATH

; For service account flow.
jsonKeyFilePath = "JSON_KEY_FILE_PATH"
scopes = "https://www.googleapis.com/auth/adwords"

c.keyfile = 'JSON_KEY_FILE_PATH'

jsonKeyFilePath=JSON_KEY_FILE_PATH

export GOOGLE_ADS_JSON_KEY_FILE_PATH=JSON_KEY_FILE_PATH

gcloud auth login --cred-file=PATH_TO_CREDENTIALS_JSON

gcloud auth \
  print-access-token \
  --scopes='https://www.googleapis.com/auth/adwords'

curl -i -X POST https://googleads.googleapis.com/v22/customers/CUSTOMER_ID/googleAds:searchStream \
   -H "Content-Type: application/json" \
   -H "Authorization: Bearer ACCESS_TOKEN" \
   -H "developer-token: DEVELOPER_TOKEN" \
   -H "login-customer-id: LOGIN_CUSTOMER_ID" \
   --data-binary "@query.json"

{
  "query": "SELECT campaign.id, campaign.name, campaign.network_settings.target_content_network FROM campaign ORDER BY campaign.id"
}