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 – идентификатор сообщества, в которое должна быть загружена история