البرنامج التجريبي لتحميل ملفّات SDF من خلال واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360"

توفّر هذه التجربة طريقة للعملاء لاختبار ميزة الإصدار التجريبي الجديدة من Display & Video 360 API التي تتيح للعملاء تحميل ملفات البيانات المنظَّمة (SDF) باستخدام Display & Video 360 API.

تسمح هذه التجربة النموذجية لكل مشروع مسجّل على Google Cloud بتحميل 30 ملف SDF كحدّ أقصى في اليوم ضمن حساب أحد المعلِنين. يمكن أن يحتوي كل ملف على 10,000 إدخال كحد أقصى.

راجِع دليل تحميل ملفات SDF للحصول على تعليمات حول كيفية استخدام الميزة التجريبية.

البدء

بعد البدء باستخدام Display & Video 360 API، عليك إكمال الخطوات التالية لاستخدام الميزات التجريبية.

تسجيل مشروعك على Google Cloud في البرنامج التجريبي

يمكن فقط للعملاء الذين طلبوا الوصول إلى البرنامج التجريبي وتمت الموافقة على طلبهم استخدام ميزات البرنامج التجريبي.

تأكَّد من ممثل المبيعات في Google من أنّ رقم تعريف مشروعك على Google Cloud مسجَّل في البرنامج التجريبي قبل محاولة استخدام ميزات البرنامج التجريبي.

إنشاء مفتاح واجهة برمجة تطبيقات

بالإضافة إلى بيانات الاعتماد العادية لواجهة برمجة التطبيقات في "مساحة العرض والفيديو 360"، عليك استخدام مفتاح لواجهة برمجة التطبيقات. أنشئ مفتاح واجهة برمجة تطبيقات لمشروعك على Google Cloud لاستخدامه في إعدادات العميل.

إعداد البرنامج

استخدِم مكتبة برامج Google API للغة Python للوصول إلى هذه الميزات التجريبية.

في ما يلي كيفية تثبيت مكتبة البرامج وإعدادها لإرسال طلبات إلى الميزات التجريبية:

Python

تثبيت google-api-python-client

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

استيراد المكتبات الضرورية

from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient import discovery

حمِّل ملف أسرار العميل وأنشئ بيانات اعتماد التفويض.

ملاحظة: عند تنفيذ هذه الخطوة للمرة الأولى، سيُطلب منك قبول طلب تفويض في المتصفّح. قبل قبول الطلب، تأكَّد من تسجيل الدخول باستخدام حساب Google لديه إذن الوصول إلى "مساحة العرض والفيديو 360 ". سيتم منح تطبيقك الإذن بالوصول إلى البيانات نيابةً عن الحساب الذي تم تسجيل الدخول إليه. يمكنك الاطّلاع على دليل تفويض الطلبات للحصول على مزيد من التفاصيل حول أذونات المستخدمين في "مساحة العرض والفيديو 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()
```

إنشاء عنصر خدمة معتمَد باستخدام خدمة الاكتشاف

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

اتّبِع التعليمات الواردة في دليل الميزات لبدء تحميل ملفات البيانات المنظَّمة.