راه‌اندازی دسترسی میانای برنامه‌سازی کاربردی

در اینجا نحوه تنظیم دسترسی به «میانای برنامه‌سازی کاربردی مدیر داده» با کیت توسعه نرم‌افزار یا REST آمده است.

پیش‌نیازها

  1. پروژه Google Cloud یا «حساب Google» که می‌خواهید مالک پروژه باشد.

    • اگر پروژه ندارید، روند راه‌اندازی در بخش بعدی پروژه‌ای برایتان ایجاد می‌کند.

    • اگر ازقبل پروژه دارید، مطمئن شوید «حساب Google» شما نقشی داشته باشد که بتواند میاناهای برنامه‌سازی کاربردی را در پروژه فعال کند، مثل مالک، ویرایشگر، یا سرپرست استفاده از سرویس. برای بررسی نقش خود، صفحه IAM را در کنسول Google Cloud باز کنید، پروژه خود را انتخاب کنید، و «حساب Google» خود را در فهرست پیدا کنید.

      برای جزئیات بیشتر، مشاهده دسترسی فعلی را ببینید.

  2. ‫Google Cloud CLI نصب شد.

فعال کردن میانای برنامه‌سازی کاربردی

اگر قبلاً این کار را نکرده‌اید، با کلیک کردن روی فعال کردن Data Manager API یا با دنبال کردن دستورالعمل‌ها برای انجام دستی این مرحله، Data Manager API را در پروژه Google Cloud خود فعال کنید.

فعال کردن Data Manager API

اگر نمی‌توانید Data Manager API را پیدا کنید یا فعال کردن Data Manager API با خطا مواجه می‌شود، بررسی کنید «حساب Google» شما پیش‌نیازها را برآورده می‌کند.

راه‌اندازی اصالت‌سنجی

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

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

  • حساب‌های کاربر: نشان‌دهنده افرادی است که مستقیماً با سرویس‌ها و واسط‌های برنامه‌سازی کاربردی Google تعامل دارند.
  • حساب‌های خدمات: برنامه‌ها را به‌عنوان کاربر نشان می‌دهند، نه افراد را. این کتابخانه‌ها به برنامه‌هایتان اجازه می‌دهند اصالت‌سنجی و صدور مجوز را مدیریت کنند. برای مثال، اگر برنامه‌ای نیاز داشته باشد به منابع Google Cloud دسترسی پیدا کند.

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

برای راه‌اندازی ADC، حساب کاربر یا حساب سرویس را انتخاب کنید:

حساب کاربری

در اینجا مراحل اصالت‌سنجی با اطلاعات اعتباری حساب کاربری آمده است:

  1. تنظیمات پلاتفرم اصالت‌سنجی Google را برای پروژه‌تان پیکربندی کنید.

    1. صفحه نمانام‌سازی را در کنسول Google Cloud باز کنید.

    2. پروژه‌تان را انتخاب کنید.

    3. فرم را تکمیل کنید و روی ایجاد کلیک کنید.

  2. ازآنجایی‌که محدوده Data Manager API یک محدوده حساس است، مراحل زیر الزامی است:

    1. به تنظیمات دسترسی به داده‌ها برای پروژه خود بروید.

    2. روی افزودن یا برداشتن محدوده‌ها کلیک کنید.

    3. چارگوش کنار میانای برنامه‌سازی کاربردی «مدیر داده» را در فهرست محدوده‌ها علامت بزنید، و روی به‌روزرسانی کلیک کنید.

    4. روی ذخیره کلیک کنید.

    5. در کنسول Google Cloud به مخاطب بروید و تنظیمات توسعه اولیه را پیکربندی کنید:

      • وضعیت انتشار را روی آزمایش تنظیم کنید.
      • نوع کاربر را روی داخلی (اگر پروژه شما در سازمان Google Workspace است) یا خارجی (اگر در سازمان Google Workspace نیست) تنظیم کنید.
      • اگر از خارجی استفاده می‌کنید، «حساب‌های Google» را که برای تولید اطلاعات اعتباری استفاده می‌کنید به‌عنوان کاربران آزمایشی اضافه کنید.

      درباره این تنظیمات در مدیریت مخاطبان برنامه بیشتر بدانید.

  3. برای ایجاد کارخواه OAuth2 در پروژه، روی ایجاد کارخواه OAuth2 کلیک کنید، یا برای ایجاد کارخواه OAuth2 رایانه، دستورالعمل‌ها را دنبال کنید. اگر ازقبل مشتری OAuth2 رایانه دارید که می‌خواهید برای Data Manager API استفاده کنید، می‌توانید این مرحله را رد کنید.

    اگر روی ایجاد کارخواه OAuth2 کلیک کردید، وقتی از شما خواسته شد کارخواه OAuth خود را پیکربندی کنید، برنامه رایانه را انتخاب کنید تا بتوانید از کارخواه در مراحل باقی‌مانده استفاده کنید.

    ایجاد کارخواه OAuth2

    در مرحله آخر، روی بارگیری پیکربندی مشتری کلیک کنید و مکان بارگیری را که انتخاب می‌کنید یادداشت کنید.

  4. با اجرای فرمان زیر، فایل ADC محلی تولید کنید. این فرمان جریان وبی راه‌اندازی می‌کند که در آن از شما خواسته می‌شود به سیستم «حساب Google» که با API استفاده می‌کنید وارد شوید.

    PATH_TO_CLIENT_JSON را با نام فایل 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"

    اگر می‌خواهید از اطلاعات اعتباری یکسانی برای Data Manager API و Google Ads API استفاده کنید، محدوده Google Ads API را در فهرست --scopes اضافه کنید:

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

    اگر می‌خواهید از همان اطلاعات اعتباری برای Data Manager API و Display & Video 360 API استفاده کنید، محدوده Display & Video 360 API را در فهرست --scopes بگنجانید:

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

  5. بااستفاده از فرمان زیر، تأیید کنید اطلاعات اعتباری به‌درستی تنظیم شده است. اگر موفقیت‌آمیز باشد، فرمان یک کد دسترسی را در کنسول چاپ می‌کند.

    gcloud auth application-default print-access-token

حساب سرویس

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

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

    ایجاد حساب سرویس

  2. نقش IAM مصرف‌کننده استفاده از سرویس را به حساب سرویس اعطا کنید (roles/serviceusage.serviceUsageConsumer)، که شامل اجازه serviceusage.services.use است که به حساب سرویس اجازه می‌دهد درخواست‌های API را برای پروژه ارسال کند.

    gcloud projects add-iam-policy-binding PROJECT_ID \
  --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
  --role="roles/serviceusage.serviceUsageConsumer"

  3. نقش IAM سازنده نشان سرویس حساب را به حساب Google خودتان در حساب خدماتی (roles/iam.serviceAccountTokenCreator) اعطا کنید.

    gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \
  --member="user:USER_EMAIL" \
  --role="roles/iam.serviceAccountTokenCreator"

  4. با اجرای فرمان زیر، ADC را پیکربندی کنید:

    gcloud auth application-default login \
  --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform"

    اگر می‌خواهید از اطلاعات اعتباری یکسانی برای Data Manager API و Google Ads API استفاده کنید، محدوده Google Ads API را در فهرست --scopes اضافه کنید:

    gcloud auth application-default login \
  --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform"

    اگر می‌خواهید از همان اطلاعات اعتباری برای Data Manager API و Display & Video 360 API استفاده کنید، محدوده Display & Video 360 API را در فهرست --scopes بگنجانید:

    gcloud auth application-default login \
  --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform"

    وقتی از شما خواسته شد به سیستم وارد شوید، با «حساب Google» خود که نقش «ایجادکننده کد دسترسی حساب سرویس» را دارد به سیستم وارد شوید.

  5. بااستفاده از فرمان زیر، تأیید کنید اطلاعات اعتباری به‌درستی تنظیم شده است. اگر موفقیت‌آمیز باشد، فرمان کد دسترسی را در کنسول چاپ می‌کند.

    gcloud auth application-default print-access-token --scopes="https://www.googleapis.com/auth/datamanager"

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

راه‌اندازی دسترسی به حساب

حساب کاربری

برگه‌ای را که با مورد استفاده شما مطابقت دارد انتخاب کنید.

  • اگر از اطلاعات اعتباری «حساب Google» استفاده می‌کنید که کاربر در حساب‌های تبلیغ‌کننده‌ای است که می‌خواهید مدیریت کنید، تبلیغ‌کننده را انتخاب کنید.
  • اگر از اطلاعات اعتباری «حساب Google» استفاده می‌کنید که کاربر حساب شریک داده است و می‌خواهید حساب‌های تبلیغ‌کننده‌ای را که پیوند شریک به حساب شریک داده دارند مدیریت کنید، شریک داده را انتخاب کنید. حساب‌های شریک داده فقط پس‌از طی کردن فرایند تأیید صادر می‌شوند. برای شروع، فرم علاقه را تکمیل کنید.

آگهی‌دهنده

به ایمیل منسوب به کاربر اجازه دهید به Destination دسترسی داشته باشد.

دستورالعمل‌ها را دنبال کنید تا ایمیل کاربر را به حساب Google Ads یا حساب مدیر Google Ads والد اضافه کنید.

Display & Video 360

برای افزودن ایمیل کاربر به حساب، دستورالعمل‌ها را دنبال کنید.

Google Analytics

برای افزودن ایمیل کاربر به حساب، دستورالعمل‌ها را دنبال کنید.

شریک داده

به ایمیل منسوب به کاربر اجازه دهید به حساب شریک داده شما دسترسی داشته باشد. معمولاً شرکای داده از حساب سرویس برای دسترسی به API استفاده می‌کنند. بااین‌حال، اگر از حساب کاربری برای آزمایش یا اهداف دیگر استفاده می‌کنید، باید به حساب کاربری خود اجازه دهید به حساب شریک داده دسترسی داشته باشد.

ایمیل کاربر را ازطریق واسط کاربر Google Ads به حساب شریک داده اضافه کنید با دنبال کردن این دستورالعمل‌ها.

حساب سرویس

برگه‌ای را که با مورد استفاده شما مطابقت دارد انتخاب کنید.

  • اگر از اطلاعات اعتباری «حساب Google» استفاده می‌کنید که کاربر در حساب‌های تبلیغ‌کننده‌ای است که می‌خواهید مدیریت کنید، تبلیغ‌کننده را انتخاب کنید.
  • اگر از اطلاعات اعتباری «حساب Google» استفاده می‌کنید که کاربر حساب شریک داده است و می‌خواهید حساب‌های تبلیغ‌کننده‌ای را که پیوند شریک به حساب شریک داده دارند مدیریت کنید، شریک داده را انتخاب کنید. حساب‌های شریک داده فقط پس‌از طی کردن فرایند تأیید صادر می‌شوند. برای شروع، فرم علاقه را تکمیل کنید.

آگهی‌دهنده

به ایمیل منسوب به حساب سرویس خود اجازه دهید به Destination دسترسی داشته باشد.

برای افزودن حساب سرویس به حساب Google Ads یا حساب مدیر Google Ads اصلی، راه‌اندازی دسترسی به حساب را تکمیل کنید.

Display & Video 360

از دستورالعمل‌ها پیروی کنید تا کاربر Display & Video 360 را که با حساب خدمات مرتبط است ایجاد کنید.

Google Analytics

برای افزودن ایمیل حساب سرویس به حساب، دستورالعمل‌ها را دنبال کنید

شریک داده

به ایمیل مرتبط با حساب سرویس خود اجازه دهید به حساب شریک داده شما دسترسی داشته باشد.

دسترسی به حساب شریک داده ازطریق «میانای کاربر Google Ads» مدیریت می‌شود. برای افزودن حساب سرویس و تنظیم سطح دسترسی آن، مراحل راه‌اندازی دسترسی حساب را دنبال کنید.

مراحل بعدی

بعدی
نصب کتابخانه کارخواه