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