نمایش & ویدئو 360 API SDF بارگذاری آزمایشی

مهم: ما محدودیت آپلود برای این ویژگی آزمایشی را از پنج به سی SDF در روز برای هر تبلیغ‌کننده افزایش داده‌ایم.

این طرح آزمایشی راهی را برای مشتریان فراهم می‌کند تا ویژگی جدید بتای Display & Video 360 API را آزمایش کنند که به مشتریان امکان می‌دهد فایل‌های داده ساختاریافته (SDF) را با استفاده از Display & Video 360 API آپلود کنند.

این طرح آزمایشی به هر پروژه ثبت‌شده در گوگل کلود اجازه می‌دهد تا حداکثر سی فایل SDF را در روز تحت یک تبلیغ‌کننده آپلود کند. هر فایل می‌تواند حداکثر شامل ۱۰،۰۰۰ ورودی باشد.

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

شروع کنید

پس از شروع کار با رابط برنامه‌نویسی کاربردی نمایشگر و ویدئو ۳۶۰، برای استفاده از ویژگی‌های آزمایشی، این مراحل را انجام دهید.

پروژه گوگل کلود خود را در طرح آزمایشی ثبت کنید

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

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

قبل از استفاده از ویژگی‌های آزمایشی، با نماینده فروش گوگل خود تأیید کنید که شناسه پروژه Google Cloud شما در این نسخه آزمایشی ثبت شده است.

یک کلید API ایجاد کنید

علاوه بر اعتبارنامه‌های استاندارد Display & Video 360 API ، باید از یک کلید API نیز استفاده کنید. یک کلید API برای پروژه Google Cloud خود ایجاد کنید تا در پیکربندی کلاینت خود از آن استفاده کنید.

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

برای دسترسی به این ویژگی‌های آزمایشی، از کتابخانه کلاینت API گوگل برای پایتون استفاده کنید.

در اینجا نحوه نصب و پیکربندی کتابخانه کلاینت شما برای ارسال درخواست به ویژگی‌های آزمایشی آمده است:

پایتون

1. نصب google-api-python-client

   pip install --upgrade google-api-python-client
   

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

   from google_auth_oauthlib.flow import InstalledAppFlow
   from googleapiclient import discovery

3. فایل اسرار کلاینت را بارگذاری کنید و اعتبارنامه‌های مجوز را ایجاد کنید.

   توجه: اولین باری که این مرحله را انجام می‌دهید، از شما خواسته می‌شود که درخواست مجوز را در مرورگر خود بپذیرید. قبل از پذیرش، مطمئن شوید که با یک حساب گوگل که به Display & Video 360 دسترسی دارد، وارد سیستم شده‌اید. برنامه شما از طرف هر حسابی که وارد سیستم شده باشد، مجاز به دسترسی به داده‌ها خواهد بود. برای جزئیات بیشتر در مورد مجوزهای کاربر Display & Video 360، به راهنمای درخواست‌های مجوز ما مراجعه کنید.

   # Set up a flow object to create the credentials using the
   # client secrets file and OAuth scopes.
   credentials = InstalledAppFlow.from_client_secrets_file(
       path-to-client-secrets-file,
       oauth-scopes).run_local_server()

4. با استفاده از سرویس کشف، یک شیء سرویس مجاز ایجاد کنید.

   api_key = "API_KEY"
   api_name = "displayvideo"
   api_url = f"https://{api_name}.googleapis.com"
   api_version = "v4"
   api_label = "SDF_UPLOAD_ALPHA"
   
   discovery_url = (
       f"{api_url}/$discovery/rest?key={api_key}&version={api_version}&labels={api_label}"
   )
   
   service = discovery.build(api_name, api_version,
                             discoveryServiceUrl=discovery_url,
                             credentials=credentials)

شروع آپلود SDF ها

برای شروع آپلود فایل‌های داده ساختاریافته، دستورالعمل‌های موجود در راهنمای ویژگی ما را دنبال کنید.