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

حساب کاربر

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

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

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

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

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

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

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

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

   3. در فهرست دامنه‌ها، Data Manager API را پیدا کنید و چارگوش را برای هر دامنه‌ای که برنامه‌تان نیاز دارد علامت بزنید:

      • .../auth/datamanager: این محدوده را برای عملیات استاندارد API انتخاب کنید، مثلاً مدیریت داده‌های مشتری، مخاطبان، و رویدادها. این گستره اصلی است که در سراسر این راهنما استفاده می‌شود.

      • .../auth/datamanager.partnerlink: این محدوده را فقط درصورتی انتخاب کنید که شریک داده‌ای باشید که درحال ایجاد یا حذف پیوندهای شریک در حساب‌های تبلیغ‌کننده است.

   4. روی به‌روزرسانی کلیک کنید.

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

   6. در کنسول 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» استفاده می‌کنید که کاربر در حساب‌های تبلیغ‌کننده‌ای است که می‌خواهید مدیریت کنید، تبلیغ‌کننده را انتخاب کنید.
• اگر از اطلاعات کاربری «حساب Google» استفاده می‌کنید که کاربر حساب شریک داده است و می‌خواهید حساب‌های آگهی‌دهنده‌ای را که پیوند شریک به حساب شریک داده دارند مدیریت کنید، شریک داده را انتخاب کنید. حساب‌های شریک داده فقط پس‌از طی کردن فرایند تأیید صادر می‌شوند. برای شروع، فرم علاقه‌مندی را تکمیل کنید.