يمكنك إنشاء الموارد، بما في ذلك موارد YouTube، وتعديلها بشكل آلي ومجمّع من خلال تحميل ملفات البيانات المنظَّمة باستخدام واجهة برمجة التطبيقات Display & Video 360 API. تتناول هذه الصفحة كيفية إعداد ملف "بيانات منظَّمة" وتحميله باستخدام واجهة برمجة التطبيقات.
يمكن لمشروع على Google Cloud تحميل خمسة ملفات بيانات منظَّمة فقط لكل رقم تعريف مُعلِن في اليوم.
تجهيز ملف بيانات منظَّمة للتحميل
يجب أن تكون "ملفات البيانات المنظَّمة" المحمَّلة هي نُسخ معدَّلة من "ملفات البيانات المنظَّمة" التي تم تنزيلها مؤخرًا من نوع الملف نفسه وبمصدرها من المعلِن نفسه. حضِّر ملف البيانات المنظَّمة الذي تم تنزيله للتحميل من خلال إجراء التعديلات التالية:
- أضِف إدخالات لأيّ موارد جديدة تريد إنشاؤها.
- عدِّل أي إدخالات حالية للموارد التي تريد تعديلها.
- أزِل أي إدخالات ليست جديدة أو معدَّلة لتقليل حجم الملف، وتسريع وقت المعالجة، وإزالة احتمالية إجراء أي تعديلات غير مقصودة.
يُرجى التحقّق مما يلي قبل تحميل الملف:
- الملف هو ملف
CSV. - جميع الإدخالات في الملف مخصّصة للموارد ضمن المعلِن الرئيسي نفسه.
تحميل ملف
حمِّل ملف بيانات منظَّمة باستخدام الطريقة
advertisers.sdfuploadtasks.upload. يؤدي هذا الطلب
إلى إنشاء مهمة تحميل SDF Operation. تعالج هذه العملية التي تستغرق وقتًا طويلاً
الملف الذي تم تحميله، وتُنشئ الموارد وتُعدّلها استنادًا إلى
محتوى الملف، وتُنشئ ملفات نتائج تسرد التحديثات التي تمت بنجاح والتي تعذّر
إجراؤها.
في ما يلي كيفية تحميل ملف بيانات منظَّمة واسترداد
Operation الناتج:
# Import the object used as the media body for the upload request. from apiclient.http import MediaFileUpload # Provide the parent advertiser ID for the resources in the SDF. # The ID value must be a str and not an int. advertiser_id = advertiser-id # Provide the filename and local path to the media file. sdf_filename = sdf-filename sdf_path = sdf-path # Create the request body. body = { 'filename': sdf_filename, 'advertiserId': advertiser_id } # Create the upload object and use a default MIME type if not identified. media = MediaFileUpload(sdf_path) if not media.mimetype(): media = MediaFileUpload(sdf_filename,'application/octet-stream') # Upload the structured data file. upload_response = service.advertisers().sdfuploadtasks().upload( advertiserId=advertiser_id, body=body, media_body=media ).execute() # Print resulting Operation name. print(f'SDF was successfully uploaded. Operation {upload_response["name"]} was ' 'created to process the uploaded file.')