عمومی
آخرین نسخه API چیست؟
آخرین نسخه API که این سند به آن میپردازد، v1beta2 است. این نسخه، یک نسخه بتای خصوصی است که در دسترس آزمایشکنندگان مورد اعتماد قرار دارد.
چه کسانی میتوانند به API دسترسی داشته باشند؟
دسترسی به v1beta2 فقط برای پروژههای کنسول API گوگل که فهرست شدهاند، امکانپذیر است. دسترسی به مستندات API توسط یک لیست جداگانه از مجوزهای کاربر کنترل میشود.
چطور میتوانم بفهمم که پروژه کنسول من در لیست مجاز قرار گرفته است یا خیر؟
با کلیک روی عنصر API_KEY در URL زیر، یک کلید API از پروژه خود انتخاب کنید. اگر کلید API برای پروژه انتخاب شده وجود ندارد، از شما خواسته میشود که یکی ایجاد کنید. پس از اتمام، URL حاصل را کپی کرده و در مرورگر خود جایگذاری کنید.
https://displayvideo.googleapis.com/$discovery/rest?version=v1beta2&labels=V1BETA2_TRUSTED_TESTER&key=API_KEYاگر توضیح JSON از API را مشاهده کردید، پروژه شما در فهرست مجاز قرار گرفته است. اگر خطایی مشاهده کردید، پروژه شما در فهرست مجاز قرار نگرفته است.
با استفاده از API
برای دسترسی به API از چه آدرس اینترنتی (URL) استفاده کنم؟
https://displayvideo.googleapis.com
چه روشهای احراز هویتی پشتیبانی میشوند؟
OAuth 2.0 تنها روش پشتیبانیشده برای احراز هویت است. همه درخواستها باید برای محدوده زیر مجاز شوند:
-
https://www.googleapis.com/auth/display-video
میخواهم کد بنویسم. از کجا میتوانم کتابخانههای کلاینت را پیدا کنم؟
پایتون
برای دسترسی به این API میتوان از کتابخانهی کلاینت API گوگل برای پایتون که در دسترس عموم است، استفاده کرد. برای نصب کتابخانه و ایجاد یک شیء سرویس مجاز، مراحل زیر را دنبال کنید.
نصب google-api-python-client
pip install --upgrade google-api-python-client
یک شیء
credentialsمجاز دریافت کنید. برای مثال به راهنمای راهاندازی برنامه خود مراجعه کنید.با استفاده از سرویس کشف، یک شیء سرویس مجاز ایجاد کنید.
api_key = 'API_KEY' api_name = 'displayvideo' api_url = 'https://%s.googleapis.com/' % api_name api_version = 'v1beta2' discovery_url = ( '%s/$discovery/rest?key=%s&version=%s&labels=%s' % (api_url, api_key, api_version, 'V1BETA2_TRUSTED_TESTER') ) service = discovery.build(api_name, api_version, discoveryServiceUrl=discovery_url, http=credentials)