VkUpload¶
Модуль для загрузки медиафайлов в VK
-
class
vk_api.upload.
VkUpload
(vk)[source]¶ Загрузка файлов через API (https://vk.com/dev/upload_files)
Parameters: vk – объект VkApi
илиVkApiMethod
-
photo
(photos, album_id, latitude=None, longitude=None, caption=None, description=None, group_id=None)[source]¶ Загрузка изображений в альбом пользователя
Parameters: - photos (str or list) – путь к изображению(ям) или file-like объект(ы)
- album_id – идентификатор альбома
- latitude – географическая широта, заданная в градусах (от -90 до 90)
- longitude – географическая долгота, заданная в градусах (от -180 до 180)
- caption – текст описания изображения
- description – текст описания альбома
- group_id – идентификатор сообщества (если загрузка идет в группу)
-
photo_messages
(photos, peer_id=None)[source]¶ Загрузка изображений в сообщения
Parameters: - photos (str or list) – путь к изображению(ям) или file-like объект(ы)
- peer_id (int) – peer_id беседы
-
photo_group_widget
(photo, image_type)[source]¶ Загрузка изображений в коллекцию сообщества для виджетов приложений сообществ
Parameters: - photo (str) – путь к изображению или file-like объект
- image_type – тип изображиения в зависимости от выбранного виджета
(https://vk.com/dev/appWidgets.getGroupImageUploadServer) :type image_type: str
-
photo_profile
(photo, owner_id=None, crop_x=None, crop_y=None, crop_width=None)[source]¶ Загрузка изображения профиля
Parameters: - photo – путь к изображению или file-like объект
- owner_id – идентификатор сообщества или текущего пользователя. По умолчанию загрузка идет в профиль текущего пользователя. При отрицательном значении загрузка идет в группу.
- crop_x – координата X верхнего правого угла миниатюры.
- crop_y – координата Y верхнего правого угла миниатюры.
- crop_width – сторона квадрата миниатюры. При передаче всех crop_* для фотографии также будет подготовлена квадратная миниатюра.
-
photo_chat
(photo, chat_id)[source]¶ Загрузка и смена обложки в беседе
Parameters: - photo – путь к изображению или file-like объект
- chat_id – ID беседы
-
photo_wall
(photos, user_id=None, group_id=None, caption=None)[source]¶ Загрузка изображений на стену пользователя или в группу
Parameters: - photos (str or list) – путь к изображению(ям) или file-like объект(ы)
- user_id – идентификатор пользователя
- group_id – идентификатор сообщества (если загрузка идет в группу)
- caption – текст описания фотографии.
-
photo_market
(photo, group_id, main_photo=False, crop_x=None, crop_y=None, crop_width=None)[source]¶ Загрузка изображений для товаров в магазине
Parameters: - photo (str or list) – путь к изображению(ям) или file-like объект(ы)
- group_id (int) – идентификатор сообщества, для которого необходимо загрузить фотографию товара
- main_photo (bool) – является ли фотография обложкой товара
- crop_x (int) – координата x для обрезки фотографии (верхний правый угол)
- crop_y (int) – координата y для обрезки фотографии (верхний правый угол)
- crop_width (int) – ширина фотографии после обрезки в px
-
photo_market_album
(photo, group_id)[source]¶ Загрузка фотографии для подборки товаров
Parameters: - photo (str or list) – путь к изображению(ям) или file-like объект(ы)
- group_id (int) – идентификатор сообщества, для которого необходимо загрузить фотографию для подборки товаров
-
audio
(audio, artist, title)[source]¶ Загрузка аудио
Parameters: - audio – путь к аудиофайлу или file-like объект
- artist – исполнитель
- title – название
-
video
(video_file=None, link=None, name=None, description=None, is_private=None, wallpost=None, group_id=None, album_id=None, privacy_view=None, privacy_comment=None, no_comments=None, repeat=None)[source]¶ Загрузка видео
Parameters: - video_file (object or str) – путь к видеофайлу или file-like объект.
- link (str) – url для встраивания видео с внешнего сайта, например, с Youtube.
- name (str) – название видеофайла
- description (str) – описание видеофайла
- is_private (bool) – указывается 1, если видео загружается для отправки личным сообщением. После загрузки с этим параметром видеозапись не будет отображаться в списке видеозаписей пользователя и не будет доступна другим пользователям по ее идентификатору.
- wallpost (bool) – требуется ли после сохранения опубликовать запись с видео на стене.
- group_id (int) – идентификатор сообщества, в которое будет сохранен видеофайл. По умолчанию файл сохраняется на страницу текущего пользователя.
- album_id (int) – идентификатор альбома, в который будет загружен видеофайл.
- privacy_view – настройки приватности просмотра видеозаписи в специальном формате. (https://vk.com/dev/objects/privacy) Приватность доступна для видеозаписей, которые пользователь загрузил в профиль. (список слов, разделенных через запятую)
- privacy_comment – настройки приватности комментирования видеозаписи в специальном формате. (https://vk.com/dev/objects/privacy)
- no_comments (bool) – 1 — закрыть комментарии (для видео из сообществ).
- repeat (bool) – зацикливание воспроизведения видеозаписи. Флаг.
-
document
(doc, title=None, tags=None, group_id=None, to_wall=False, message_peer_id=None, doc_type=None)[source]¶ Загрузка документа
Parameters: - doc – путь к документу или file-like объект
- title – название документа
- tags – метки для поиска
- group_id – идентификатор сообщества (если загрузка идет в группу)
-
document_wall
(doc, title=None, tags=None, group_id=None)[source]¶ Загрузка документа в папку Отправленные, для последующей отправки документа на стену или личным сообщением.
Parameters: - doc – путь к документу или file-like объект
- title – название документа
- tags – метки для поиска
- group_id – идентификатор сообщества (если загрузка идет в группу)
-
document_message
(doc, title=None, tags=None, peer_id=None)[source]¶ Загрузка документа для отправки личным сообщением.
Parameters: - doc – путь к документу или file-like объект
- title – название документа
- tags – метки для поиска
- peer_id – peer_id беседы
-
audio_message
(audio, peer_id=None, group_id=None)[source]¶ Загрузка аудио-сообщения.
Parameters: - audio – путь к аудиофайлу или file-like объект
- peer_id – идентификатор диалога
- group_id – для токена группы, можно передавать ID группы, вместо peer_id
-
graffiti
(image, peer_id=None, group_id=None)[source]¶ Загрузка граффити
Parameters: - image – путь к png изображению или file-like объект.
- peer_id – идентификатор диалога (только для авторизации пользователя)
- group_id – для токена группы, нужно передавать ID группы, вместо peer_id
-
photo_cover
(photo, group_id, crop_x=None, crop_y=None, crop_x2=None, crop_y2=None)[source]¶ Загрузка изображения профиля
Parameters: - photo – путь к изображению или file-like объект
- group_id – идентификатор сообщества
- crop_x – координата X верхнего левого угла для обрезки изображения
- crop_y – координата Y верхнего левого угла для обрезки изображения
- crop_x2 – коорд. X нижнего правого угла для обрезки изображения
- crop_y2 – коорд. Y нижнего правого угла для обрезки изображения
-
story
(file, file_type, add_to_news=True, user_ids=None, reply_to_story=None, link_text=None, link_url=None, group_id=None)[source]¶ Загрузка истории
Parameters: - file – путь к изображению, гифке или видео или file-like объект
- file_type – тип истории (photo или video)
- add_to_news – размещать ли историю в новостях
- user_ids – идентификаторы пользователей, которые будут видеть историю
- reply_to_story – идентификатор истории, в ответ на которую создается новая
- link_text – текст ссылки для перехода из истории
- link_url – адрес ссылки для перехода из истории
- group_id – идентификатор сообщества, в которое должна быть загружена история
-