راه اندازی Auth

آموزش API فروشنده با نمایشگر و ویدیوی ۳۶۰ درجه

چند مرحله کلیدی برای استفاده از رابط برنامه‌نویسی کاربردی فروشنده نمایش و ویدئو ۳۶۰ وجود دارد. رابط برنامه‌نویسی کاربردی فروشنده DV360 یک رابط برنامه‌نویسی کاربردی ابری گوگل مبتنی بر فهرست مجوز است و از OAuth 2.0 برای احراز هویت و مجوز استفاده می‌کند.

فرآیند فعال‌سازی توسط تیم رابط برنامه‌نویسی نرم‌افزار فروشنده‌ی Display & Video 360 انجام می‌شود.

توجه: اگر برنامه شما به API فروشنده DV360 دسترسی دارد، باید بررسی تأیید OAuth را با موفقیت پشت سر بگذارد. اگر هنگام آزمایش برنامه خود، برنامه تأیید نشده را روی صفحه مشاهده کردید، باید درخواست تأیید برای حذف آن ارسال کنید. درباره برنامه‌های تأیید نشده بیشتر بدانید یا به سوالات متداول در مورد تأیید برنامه پاسخ دهید.

مراحل پذیرش:

1. با مراجعه به آدرس https://console.cloud.google.com/ برای یک حساب گوگل ثبت نام کنید.
   • این حساب برای مدیریت توکن‌های دسترسی برای کلاینت تولید شما استفاده خواهد شد. از حساب جیمیل شخصی استفاده نکنید.
   • این حساب نمی‌تواند یک گروه گوگل باشد.
   • اگر از یک پروژه Google Cloud موجود استفاده می‌کنید: حساب کاربری باید مدیر پروژه باشد.
2. برای اضافه کردن آن به لیست مجاز، با تیم Google DV360 تماس بگیرید و اطلاعات حساب خود را ارائه دهید.
3. منتظر تایید فعال شدن حساب کاربری خود باشید.
4. اختیاری و غیر مسدودکننده: برای دسترسی به محدوده https://www.googleapis.com/auth/doubleclickbidmanager یک درخواست بررسی تأیید OAuth برای برنامه خود ارسال کنید.
5. در کنسول گوگل کلود ، به APIs & Services > Library > Private بروید. باید API فروشنده DV360 را که برای پروژه شما در دسترس است، ببینید.
6. API فروشنده DV360 را فعال کنید.
7. به APIها و خدمات > اعتبارنامه‌ها > ایجاد اعتبارنامه‌ها > کلید حساب سرویس بروید. دستورالعمل‌های راه‌اندازی را در مستندات حساب سرویس OAuth 2.0 دنبال کنید.

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

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

   احراز هویت و مجوزدهی API گوگل کلود (که معمولاً به عنوان "auth" گروه‌بندی می‌شوند) معمولاً با استفاده از یک حساب کاربری سرویس انجام می‌شود. یک حساب کاربری سرویس به کد شما اجازه می‌دهد تا اعتبارنامه‌های برنامه را مستقیماً به API کلود ارسال کند. یک حساب کاربری سرویس، مانند یک حساب کاربری، با یک آدرس ایمیل نمایش داده می‌شود. با این حال، برخلاف یک حساب کاربری، یک حساب کاربری سرویس فقط متعلق به یک برنامه است و فقط می‌تواند برای دسترسی به API که برای آن ایجاد شده است، استفاده شود. به عنوان مثال، این راهنما نحوه ایجاد اعتبارنامه‌های حساب کاربری سرویس را با استفاده از کنسول گوگل کلود نشان می‌دهد.

   استفاده از کنسول گوگل کلود

   از صفحه مدیریت API کنسول Google Cloud → Credentials ، گزینه «ایجاد اعتبارنامه‌ها→ کلید حساب سرویس» را انتخاب کنید.

   

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

   

   برای این حساب سرویس، یک «نام» تایپ کنید. این نام به عنوان نام پیش‌فرض برای «شناسه حساب سرویس» شما (در سمت چپ «@» در آدرس شناسه حساب سرویس تولید شده) استفاده خواهد شد، اما در صورت تمایل می‌توانید نام شناسه حساب سرویس را تغییر دهید. این نام‌ها می‌توانند دلخواه باشند؛ فقط مهم است که آنها را به خاطر بسپارید. در قسمت «نوع کلید»، توصیه می‌کنیم این مقدار را «JSON» بگذارید. روی «ایجاد» کلیک کنید، و کنسول Google Cloud یک کلید JSON (به صورت یک فایل متنی .json ) ایجاد می‌کند، از شما می‌خواهد که فایل را در رایانه خود دانلود کنید و یک کادر محاوره‌ای ایجاد حساب سرویس نمایش می‌دهد.

   

   کلید JSON تولید شده مشابه کلید JSON نمونه زیر خواهد بود:

   {
     "type": "service_account",
     "project_id": "project-id",
     "private_key_id": "some_number",
     "private_key": "-----BEGIN PRIVATE KEY-----\n....
     =\n-----END PRIVATE KEY-----\n",
     "client_email": "<api-name>[e-mail]",
     "client_id": "...",
     "auth_uri": "https://accounts.google.com/o/oauth2/auth",
     "token_uri": "https://accounts.google.com/o/oauth2/token",
     "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
     "client_x509_cert_url": "https://www.googleapis.com/...<api-name>api%40project-id.iam.gserviceaccount.com"
   }

   این فایل JSON را به طور ایمن ذخیره کنید، زیرا حاوی کلید خصوصی شما است (و این فایل تنها کپی از آن کلید است). هنگام ارسال اعتبارنامه‌ها به Google Cloud API، باید در کد خود به این فایل کلید حساب سرویس مراجعه کنید.

8. با اطلاعات حساب سرویسی که ایجاد کرده‌اید (به‌طور خاص، آدرس ایمیل حساب سرویس) با تیم DV360 تماس بگیرید. این دومین مرحله از لیست مجوزها برای مجوزدهی است.
9. پس از اینکه حساب کاربری سرویس شما برای فراخوانی API مجاز شد، می‌توانید به مستندات API فروشنده DV360 مراجعه کنید. برای دریافت توکن احراز هویت به صورت دستی، به دستورالعمل‌های موجود در مخزن ابزار oauth2l (با استفاده از کلید حساب کاربری سرویس JSON دانلود شده خود) مراجعه کنید. دستورالعمل‌های دقیق در مورد دریافت توکن‌های OAuth از طریق برنامه‌نویسی در مستندات احراز هویت Google Cloud موجود است.

مهم: محدوده OAuth باید https://www.googleapis.com/auth/doubleclickbidmanager باشد.

،

آموزش API فروشنده با نمایشگر و ویدیوی ۳۶۰ درجه

چند مرحله کلیدی برای استفاده از رابط برنامه‌نویسی کاربردی فروشنده نمایش و ویدئو ۳۶۰ وجود دارد. رابط برنامه‌نویسی کاربردی فروشنده DV360 یک رابط برنامه‌نویسی کاربردی ابری گوگل مبتنی بر فهرست مجوز است و از OAuth 2.0 برای احراز هویت و مجوز استفاده می‌کند.

فرآیند فعال‌سازی توسط تیم رابط برنامه‌نویسی نرم‌افزار فروشنده‌ی Display & Video 360 انجام می‌شود.

توجه: اگر برنامه شما به API فروشنده DV360 دسترسی دارد، باید بررسی تأیید OAuth را با موفقیت پشت سر بگذارد. اگر هنگام آزمایش برنامه خود، برنامه تأیید نشده را روی صفحه مشاهده کردید، باید درخواست تأیید برای حذف آن ارسال کنید. درباره برنامه‌های تأیید نشده بیشتر بدانید یا به سوالات متداول در مورد تأیید برنامه پاسخ دهید.

مراحل پذیرش:

1. با مراجعه به آدرس https://console.cloud.google.com/ برای یک حساب گوگل ثبت نام کنید.
   • این حساب برای مدیریت توکن‌های دسترسی برای کلاینت تولید شما استفاده خواهد شد. از حساب جیمیل شخصی استفاده نکنید.
   • این حساب نمی‌تواند یک گروه گوگل باشد.
   • اگر از یک پروژه Google Cloud موجود استفاده می‌کنید: حساب کاربری باید مدیر پروژه باشد.
2. برای اضافه کردن آن به لیست مجاز، با تیم Google DV360 تماس بگیرید و اطلاعات حساب خود را ارائه دهید.
3. منتظر تایید فعال شدن حساب کاربری خود باشید.
4. اختیاری و غیر مسدودکننده: برای دسترسی به محدوده https://www.googleapis.com/auth/doubleclickbidmanager یک درخواست بررسی تأیید OAuth برای برنامه خود ارسال کنید.
5. در کنسول گوگل کلود ، به APIs & Services > Library > Private بروید. باید API فروشنده DV360 را که برای پروژه شما در دسترس است، ببینید.
6. API فروشنده DV360 را فعال کنید.
7. به APIها و خدمات > اعتبارنامه‌ها > ایجاد اعتبارنامه‌ها > کلید حساب سرویس بروید. دستورالعمل‌های راه‌اندازی را در مستندات حساب سرویس OAuth 2.0 دنبال کنید.

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

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

   احراز هویت و مجوزدهی API گوگل کلود (که معمولاً به عنوان "auth" گروه‌بندی می‌شوند) معمولاً با استفاده از یک حساب کاربری سرویس انجام می‌شود. یک حساب کاربری سرویس به کد شما اجازه می‌دهد تا اعتبارنامه‌های برنامه را مستقیماً به API کلود ارسال کند. یک حساب کاربری سرویس، مانند یک حساب کاربری، با یک آدرس ایمیل نمایش داده می‌شود. با این حال، برخلاف یک حساب کاربری، یک حساب کاربری سرویس فقط متعلق به یک برنامه است و فقط می‌تواند برای دسترسی به API که برای آن ایجاد شده است، استفاده شود. به عنوان مثال، این راهنما نحوه ایجاد اعتبارنامه‌های حساب کاربری سرویس را با استفاده از کنسول گوگل کلود نشان می‌دهد.

   استفاده از کنسول گوگل کلود

   از صفحه مدیریت API کنسول Google Cloud → Credentials ، گزینه «ایجاد اعتبارنامه‌ها→ کلید حساب سرویس» را انتخاب کنید.

   

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

   

   برای این حساب سرویس، یک «نام» تایپ کنید. این نام به عنوان نام پیش‌فرض برای «شناسه حساب سرویس» شما (در سمت چپ «@» در آدرس شناسه حساب سرویس تولید شده) استفاده خواهد شد، اما در صورت تمایل می‌توانید نام شناسه حساب سرویس را تغییر دهید. این نام‌ها می‌توانند دلخواه باشند؛ فقط مهم است که آنها را به خاطر بسپارید. در قسمت «نوع کلید»، توصیه می‌کنیم این مقدار را «JSON» بگذارید. روی «ایجاد» کلیک کنید، و کنسول Google Cloud یک کلید JSON (به صورت یک فایل متنی .json ) ایجاد می‌کند، از شما می‌خواهد که فایل را در رایانه خود دانلود کنید و یک کادر محاوره‌ای ایجاد حساب سرویس نمایش می‌دهد.

   

   کلید JSON تولید شده مشابه کلید JSON نمونه زیر خواهد بود:

   {
     "type": "service_account",
     "project_id": "project-id",
     "private_key_id": "some_number",
     "private_key": "-----BEGIN PRIVATE KEY-----\n....
     =\n-----END PRIVATE KEY-----\n",
     "client_email": "<api-name>[e-mail]",
     "client_id": "...",
     "auth_uri": "https://accounts.google.com/o/oauth2/auth",
     "token_uri": "https://accounts.google.com/o/oauth2/token",
     "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
     "client_x509_cert_url": "https://www.googleapis.com/...<api-name>api%40project-id.iam.gserviceaccount.com"
   }

   این فایل JSON را به طور ایمن ذخیره کنید، زیرا حاوی کلید خصوصی شما است (و این فایل تنها کپی از آن کلید است). هنگام ارسال اعتبارنامه‌ها به Google Cloud API، باید در کد خود به این فایل کلید حساب سرویس مراجعه کنید.

8. با اطلاعات حساب سرویسی که ایجاد کرده‌اید (به‌طور خاص، آدرس ایمیل حساب سرویس) با تیم DV360 تماس بگیرید. این دومین مرحله از لیست مجوزها برای مجوزدهی است.
9. پس از اینکه حساب کاربری سرویس شما برای فراخوانی API مجاز شد، می‌توانید به مستندات API فروشنده DV360 مراجعه کنید. برای دریافت توکن احراز هویت به صورت دستی، به دستورالعمل‌های موجود در مخزن ابزار oauth2l (با استفاده از کلید حساب کاربری سرویس JSON دانلود شده خود) مراجعه کنید. دستورالعمل‌های دقیق در مورد دریافت توکن‌های OAuth از طریق برنامه‌نویسی در مستندات احراز هویت Google Cloud موجود است.

مهم: محدوده OAuth باید https://www.googleapis.com/auth/doubleclickbidmanager باشد.

،

آموزش API فروشنده با نمایشگر و ویدیوی ۳۶۰ درجه

چند مرحله کلیدی برای استفاده از رابط برنامه‌نویسی کاربردی فروشنده نمایش و ویدئو ۳۶۰ وجود دارد. رابط برنامه‌نویسی کاربردی فروشنده DV360 یک رابط برنامه‌نویسی کاربردی ابری گوگل مبتنی بر فهرست مجوز است و از OAuth 2.0 برای احراز هویت و مجوز استفاده می‌کند.

فرآیند فعال‌سازی توسط تیم رابط برنامه‌نویسی نرم‌افزار فروشنده‌ی Display & Video 360 انجام می‌شود.

توجه: اگر برنامه شما به API فروشنده DV360 دسترسی دارد، باید بررسی تأیید OAuth را با موفقیت پشت سر بگذارد. اگر هنگام آزمایش برنامه خود، برنامه تأیید نشده را روی صفحه مشاهده کردید، باید درخواست تأیید برای حذف آن ارسال کنید. درباره برنامه‌های تأیید نشده بیشتر بدانید یا به سوالات متداول در مورد تأیید برنامه پاسخ دهید.

مراحل پذیرش:

1. با مراجعه به آدرس https://console.cloud.google.com/ برای یک حساب گوگل ثبت نام کنید.
   • این حساب برای مدیریت توکن‌های دسترسی برای کلاینت تولید شما استفاده خواهد شد. از حساب جیمیل شخصی استفاده نکنید.
   • این حساب نمی‌تواند یک گروه گوگل باشد.
   • اگر از یک پروژه Google Cloud موجود استفاده می‌کنید: حساب کاربری باید مدیر پروژه باشد.
2. برای اضافه کردن آن به لیست مجاز، با تیم Google DV360 تماس بگیرید و اطلاعات حساب خود را ارائه دهید.
3. منتظر تایید فعال شدن حساب کاربری خود باشید.
4. اختیاری و غیر مسدودکننده: برای دسترسی به محدوده https://www.googleapis.com/auth/doubleclickbidmanager یک درخواست بررسی تأیید OAuth برای برنامه خود ارسال کنید.
5. در کنسول گوگل کلود ، به APIs & Services > Library > Private بروید. باید API فروشنده DV360 را که برای پروژه شما در دسترس است، ببینید.
6. API فروشنده DV360 را فعال کنید.
7. به APIها و خدمات > اعتبارنامه‌ها > ایجاد اعتبارنامه‌ها > کلید حساب سرویس بروید. دستورالعمل‌های راه‌اندازی را در مستندات حساب سرویس OAuth 2.0 دنبال کنید.

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

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

   احراز هویت و مجوزدهی API گوگل کلود (که معمولاً به عنوان "auth" گروه‌بندی می‌شوند) معمولاً با استفاده از یک حساب کاربری سرویس انجام می‌شود. یک حساب کاربری سرویس به کد شما اجازه می‌دهد تا اعتبارنامه‌های برنامه را مستقیماً به API کلود ارسال کند. یک حساب کاربری سرویس، مانند یک حساب کاربری، با یک آدرس ایمیل نمایش داده می‌شود. با این حال، برخلاف یک حساب کاربری، یک حساب کاربری سرویس فقط متعلق به یک برنامه است و فقط می‌تواند برای دسترسی به API که برای آن ایجاد شده است، استفاده شود. به عنوان مثال، این راهنما نحوه ایجاد اعتبارنامه‌های حساب کاربری سرویس را با استفاده از کنسول گوگل کلود نشان می‌دهد.

   استفاده از کنسول گوگل کلود

   از صفحه مدیریت API کنسول Google Cloud → Credentials ، گزینه «ایجاد اعتبارنامه‌ها→ کلید حساب سرویس» را انتخاب کنید.

   

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

   

   برای این حساب سرویس، یک «نام» تایپ کنید. این نام به عنوان نام پیش‌فرض برای «شناسه حساب سرویس» شما (در سمت چپ «@» در آدرس شناسه حساب سرویس تولید شده) استفاده خواهد شد، اما در صورت تمایل می‌توانید نام شناسه حساب سرویس را تغییر دهید. این نام‌ها می‌توانند دلخواه باشند؛ فقط مهم است که آنها را به خاطر بسپارید. در قسمت «نوع کلید»، توصیه می‌کنیم این مقدار را «JSON» بگذارید. روی «ایجاد» کلیک کنید، و کنسول Google Cloud یک کلید JSON (به صورت یک فایل متنی .json ) ایجاد می‌کند، از شما می‌خواهد که فایل را در رایانه خود دانلود کنید و یک کادر محاوره‌ای ایجاد حساب سرویس نمایش می‌دهد.

   

   کلید JSON تولید شده مشابه کلید JSON نمونه زیر خواهد بود:

   {
     "type": "service_account",
     "project_id": "project-id",
     "private_key_id": "some_number",
     "private_key": "-----BEGIN PRIVATE KEY-----\n....
     =\n-----END PRIVATE KEY-----\n",
     "client_email": "<api-name>[e-mail]",
     "client_id": "...",
     "auth_uri": "https://accounts.google.com/o/oauth2/auth",
     "token_uri": "https://accounts.google.com/o/oauth2/token",
     "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
     "client_x509_cert_url": "https://www.googleapis.com/...<api-name>api%40project-id.iam.gserviceaccount.com"
   }

   این فایل JSON را به طور ایمن ذخیره کنید، زیرا حاوی کلید خصوصی شما است (و این فایل تنها کپی از آن کلید است). هنگام ارسال اعتبارنامه‌ها به Google Cloud API، باید در کد خود به این فایل کلید حساب سرویس مراجعه کنید.

8. با اطلاعات حساب سرویسی که ایجاد کرده‌اید (به‌طور خاص، آدرس ایمیل حساب سرویس) با تیم DV360 تماس بگیرید. این دومین مرحله از لیست مجوزها برای مجوزدهی است.
9. پس از اینکه حساب کاربری سرویس شما برای فراخوانی API مجاز شد، می‌توانید به مستندات API فروشنده DV360 مراجعه کنید. برای دریافت توکن احراز هویت به صورت دستی، به دستورالعمل‌های موجود در مخزن ابزار oauth2l (با استفاده از کلید حساب کاربری سرویس JSON دانلود شده خود) مراجعه کنید. دستورالعمل‌های دقیق در مورد دریافت توکن‌های OAuth از طریق برنامه‌نویسی در مستندات احراز هویت Google Cloud موجود است.

مهم: محدوده OAuth باید https://www.googleapis.com/auth/doubleclickbidmanager باشد.