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

ملاحظة مهمة: رفعنا الحد الأقصى لعدد عمليات التحميل المسموح بها في هذه الميزة التجريبية من خمسة إلى ثلاثين ملفًا من "وصف بيانات الإعلان المنظَّمة" يوميًا لكل معلِن.

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

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

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

البدء

بعد البدء باستخدام واجهة برمجة التطبيقات الخاصة بـ "مساحة العرض والفيديو 360"، عليك إكمال الخطوات التالية لاستخدام الميزات التجريبية.

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

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

يُرجى التواصل مع ممثل مبيعات Google للحصول على مزيد من المعلومات حول كيفية تسجيل مشروعك على Google Cloud في التشغيل التجريبي.

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

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

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

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

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

Python

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. حمِّل ملف أسرار العميل وأنشئ بيانات اعتماد التفويض.

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

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

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