سوالات متداول

عمومی

آخرین نسخه API چیست؟

آخرین نسخه API که این سند به آن آدرس می دهد v3 است.

آیا می توانم داده های عملکرد را با استفاده از این API بازیابی کنم؟

خیر. از Bid Manager API برای ایجاد، بازیابی و اجرای گزارش‌های آفلاین Display & Video 360 استفاده کنید.

از API استفاده کنید

از چه URL برای دسترسی به API استفاده کنم؟

https://displayvideo.googleapis.com

چه روش هایی برای احراز هویت پشتیبانی می شوند؟

OAuth 2.0 تنها روش پشتیبانی شده برای احراز هویت است.

درخواست‌های Display & Video 360 API باید برای حوزه زیر مجاز باشند:

• https://www.googleapis.com/auth/display-video

درخواست‌ها به سرویس users نیز باید برای دامنه اضافی زیر مجاز باشد:

• https://www.googleapis.com/auth/display-video-user-management

میخوام کد بنویسم از کجا می توانم کتابخانه های مشتری را پیدا کنم؟

به راهنمای کتابخانه مشتری مراجعه کنید.

اگر نخواهم از کتابخانه مشتری استفاده کنم چه می شود؟

توصیه می کنیم از یکی از کتابخانه های سرویس گیرنده ما استفاده کنید، اما همچنین می توانید با استفاده از درخواست های مستقیم HTTP با Display & Video 360 API تعامل داشته باشید.

برخی از روش‌های درگیرتر، مانند advertisers.assets.upload و media.upload ، ترجمه مستقیم به درخواست‌های HTTP دشوارتر است. نمونه‌هایی از درخواست‌های HTTP به این روش‌ها را با استفاده از cURL در راهنمای پیشنهادات خلاقانه و سفارشی ما ببینید.

به چه مجوزهای Display & Video 360 نیاز دارم؟

برای استفاده از Display & Video 360 API، حساب Google احراز هویت باید یک کاربر Display & Video 360 با دسترسی به شرکا یا تبلیغ‌کنندگان مربوطه باشد.

کاربر Display & Video 360 باید یکی از نقش‌های کاربری زیر را داشته باشد تا شرکا یا تبلیغ‌کنندگان مربوطه اقدامات زیر را انجام دهند:

• فقط خواندن : منابع را با استفاده از تماس‌های get یا list ، به استثنای منابع user ، بازیابی کنید.
• استاندارد : منابع را بازیابی، ایجاد و به روز کنید. منابع user را با مجوزهای مشابه شرکا یا تبلیغ‌کنندگان بازیابی کنید.
• Admin : منابع را بازیابی، ایجاد و به روز کنید. بازیابی، ایجاد و دسترسی به منابع user برای شرکا یا تبلیغ‌کنندگانی که مدیریت می‌کنید.

چگونه منابع YouTube & Partners را با استفاده از API به روز کنم؟

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

چگونه مکان های جغرافیایی را هدف قرار دهم؟

هدف گذاری جغرافیایی را می توان با استفاده از انواع هدف گذاری زیر به موارد خط اختصاص داد:

• TARGETING_TYPE_GEO_REGION
• TARGETING_TYPE_POI
• TARGETING_TYPE_BUSINESS_CHAIN
• TARGETING_TYPE_REGIONAL_LOCATION_LIST
• TARGETING_TYPE_PROXIMITY_LOCATION_LIST

با استفاده از targetingTypes.targetingOptions.search شناسه‌های گزینه هدف را برای سه نوع هدف اول بازیابی کنید. منابع لیست مکان را با استفاده از سرویس advertisers.locationLists بازیابی و مدیریت کنید.

علاوه بر این، همچنین می‌توانید شناسه گزینه هدف‌گیری TARGETING_TYPE_POI بسازید تا مستقیماً شعاع مجاورتی را در اطراف مختصات طول و عرض جغرافیایی خاص هدف قرار دهید.

می بینم که می توانم فایل های داده های ساختاریافته (SDF) را با استفاده از API دانلود کنم، اما چگونه آنها را آپلود کنم؟

API Display & Video 360 از آپلود SDF پشتیبانی نمی کند. ما مدیریت منابع را از طریق روش‌های CREATE ، PATCH ، و DELETE که توسط API ارائه شده است، توصیه می‌کنیم. اگر همچنان می‌خواهید منابع را با استفاده از SDF مدیریت کنید، آن فایل‌ها را می‌توان در رابط Display & Video 360 به‌روزرسانی کرد.

حمایت کردن

آیا API مشکلات یا محدودیت های شناخته شده ای دارد؟

محدودیت‌هایی در تعداد درخواست‌هایی که پروژه شما می‌تواند در هر ثانیه ارائه کند وجود دارد، که در راهنمای محدودیت‌های استفاده ما توضیح داده شده است.