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