يتيح Display & Video 360 API الآن إدارة موارد "حملات زيادة الطلب". اطّلِع على دليلنا الجديد للتعرّف على كيفية إنشاء حملة إعلانية لزيادة الطلب وتشغيلها.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

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

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

البدء

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

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

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

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

بالإضافة إلى بيانات الاعتماد العادية في Display & Video 360 API، عليك استخدام مفتاح واجهة برمجة تطبيقات. أنشئ مفتاح واجهة برمجة تطبيقات لمشروعك على السحابة الإلكترونية على 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)

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