diff --git a/Project/Vkontakte-iOS-SDK-LV/Documentation/docset-installed.txt b/Project/Vkontakte-iOS-SDK-LV/Documentation/docset-installed.txt index 1c8a685..f3084df 100644 --- a/Project/Vkontakte-iOS-SDK-LV/Documentation/docset-installed.txt +++ b/Project/Vkontakte-iOS-SDK-LV/Documentation/docset-installed.txt @@ -1,4 +1,4 @@ Documentation set was installed to Xcode! Path: /Users/new/Library/Developer/Shared/Documentation/DocSets/com.andrewshmig.Vkontakte-iOS-SDK-LV.docset -Time: 2013-11-15 11:13:08 +0000 \ No newline at end of file +Time: 2013-11-20 17:40:22 +0000 \ No newline at end of file diff --git a/Project/Vkontakte-iOS-SDK-LV/Documentation/docset/Contents/Resources/Documents/Classes/VKAccessToken.html b/Project/Vkontakte-iOS-SDK-LV/Documentation/docset/Contents/Resources/Documents/Classes/VKAccessToken.html index 1714928..d5b5102 100644 --- a/Project/Vkontakte-iOS-SDK-LV/Documentation/docset/Contents/Resources/Documents/Classes/VKAccessToken.html +++ b/Project/Vkontakte-iOS-SDK-LV/Documentation/docset/Contents/Resources/Documents/Classes/VKAccessToken.html @@ -88,13 +88,13 @@
Класс содержит информацию о пользовательском токене доступа.
- -Кроме самого токена доступа хранится следующая информация:
+Current class works with user access token and stores information about +it:
permissions
- Массив пользовательских разрешений к которым был получен доступ приложением
+Array of permissions which were granted to current application
property creationTime
- Время создания токена
+Access token creation time
property liveTime
- Время жизни токена доступа.
+Access token life time.
property userID
- Пользовательский идентификатор в социальной сети ВКонтакте.
+Unique user identifier
property token
- Токен доступа.
+Token (access token)
property isExpired
- Истекло ли время действия текущего токена доступа или нет. -NO - если токен всё еще действует, иначе - YES.
+Is current access token expired?
property isValid
- Действителен ли токен.
+Is current access token valid?
property @@ -258,28 +256,28 @@– initWithUserID:accessToken:liveTime:permissions:
- Основной метод инициализации.
+Designated initialization method
– initWithUserID:accessToken:liveTime:
- Вторичный метод инициализации класса.
+Initialization method
– initWithUserID:accessToken:
- Вторичный метод инициализации класса.
+Initialization method
@@ -287,21 +285,21 @@– description
- Описание состояния класса VKAccessToken.
+Access token description.
– isEqual:
- Проверяет токены доступов на равенство
+Checks if two access tokens are equal.
@@ -309,14 +307,14 @@– hasPermission:
- Метод проверяет наличие определенного доступа в общем списке доступов данного токена.
+Method checks if list of permissions contains a permission.
@@ -340,7 +338,7 @@Время создания токена
+Access token creation time
Истекло ли время действия текущего токена доступа или нет. -NO - если токен всё еще действует, иначе - YES.
+Is current access token expired?
NO в следующих случаях:
+Current token is not expired if:
Действителен ли токен.
+Is current access token valid?
Возвращает YES, если токен неравен nil и срок его действия не истек.
+Returns YES if current access token is not nil and its not expired.
Время жизни токена доступа.
+Access token life time.
Массив пользовательских разрешений к которым был получен доступ приложением
+Array of permissions which were granted to current application
Токен доступа.
+Token (access token)
Пользовательский идентификатор в социальной сети ВКонтакте.
+Unique user identifier
Описание состояния класса VKAccessToken.
+Access token description.
Строковое представление текущего класса.
+String representation.
Метод проверяет наличие определенного доступа в общем списке доступов данного токена.
+Method checks if list of permissions contains a permission.
Наименование доступа.
permissions name (wall, offline, friends etc)
YES - если такое право присутствует в общем списке, иначе - NO.
+YES - if list of permissions contains current permission, otherwise NO +is returned.
Вторичный метод инициализации класса.
+Initialization method
Пользовательский идентификатор в социальной сети ВКонтакте
unique user identifier
Токен доступа.
access token
Объект VKAccessToken класса.
+instance of VKAccessToken class
permissions принимает значение по умолчанию @[].
- -liveTime принимает значение по умолчанию 0.
+List of permissions defaults to an empty list (@[]). +liveTime defaults to 0 (zero).
Вторичный метод инициализации класса.
+Initialization method
Пользовательский идентификатор в социальной сети ВКонтакте.
unique user identifier
Токен доступа.
access token
Время жизни токена доступа.
access token life time
Объект VKAccessToken класса.
+instance of VKAccessToken class
permissions принимает значение по умолчанию @[].
+List of permissions defaults to an empty list (@[]).
Основной метод инициализации.
+Designated initialization method
Пользовательский идентификатор в социальной сети ВКонтакте.
unique user identifier
Токен доступа.
access token
Время жизни токена доступа.
access token life time
Список полученных приложением прав.
list of all granted permissions
Объект VKAccessToken класса.
+instance of VKAccessToken class
Проверяет токены доступов на равенство
+Checks if two access tokens are equal.
токен доступа с которым необходимо сравнить
another access token
YES - если токены доступа равны (на результат сравнения влияет только сам -токен доступа, список пользовательских разрешений и идентификатор пользователя, которому -принадлежит данный токен)
+YES - if two access tokens are equal (tokens are equal if and only if their +corresponding tokens, list of permissions and userIDs are equal), otherwise NO +is returned.
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-15)
+
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-20)
Generated by appledoc 2.1 (build 858).
Класс предназначен для хранения, получения, удаления кэша запросов. -Хранение кэша осуществляется на диске и в директории указанной при инициализации -класса.
+Current class manages cached responses' data. Cached data are saved in +directory which was selected during initialization process.
– initWithCacheDirectory:
- Инициализация объекта для кэширования запросов
+Initialization methods
@@ -175,43 +174,42 @@– addCache:forURL:
- Добавляет данные в кэш
+Current method adds new data to cached data directory
– addCache:forURL:liveTime:
- Добавляет данные в кэш
+Current method adds new data to cached data directory
– removeCacheForURL:
- Удаление кэша указанного URL
+Removes cached data by its URL
– clear
- Удаление всех закэшированных данных в директории, которой был инициализирован -данный объект
+Removes all cached data in a directory which were used for initialization.
– removeCacheDirectory
- Удаление директории с данными кэша
+Removes directory with all cached data.
@@ -219,23 +217,22 @@– cacheForURL:
- Возвращает закэшированные данные по указанному URL, либо nil, если время действия -кэша истекло или его нет.
+Returns cached data by its URL, or nil, if life time of cached data has expired.
– cacheForURL:offlineMode:
- Возвращает закэшированные данные по указанному URL, либо nil, если для данного -запроса нет кэша.
+Returns cached data by its URL, or nil, if life time of cached data has +expired or there is no data for current URL.
@@ -263,7 +260,7 @@Добавляет данные в кэш
+Current method adds new data to cached data directory
данные, которые необходимо закэшировать
data which should be cached
URL который соответствует кешируемым данным
URL that corresponds to cached data
По умолчанию время жизни кэша устанавливается равным одному часу.
+Life time of current cached data defaults to one hour.
Добавляет данные в кэш
+Current method adds new data to cached data directory
данные, которые необходимо закэшировать
data which should be cached
URL который соответствует кешируемым данным
URL that corresponds to cached data
время жизни кэша. Возможные варианты перечислены в VKCacheLiveTime -(VKCacheLiveTimeOneHour, VKCacheLiveTimeOneDay, VKCacheLiveTimeForever etc)
life time of current cached data (possible values: VKCacheLiveTimeOneHour, +VKCacheLiveTimeOneDay, VKCacheLiveTimeForever etc).
Возвращает закэшированные данные по указанному URL, либо nil, если время действия -кэша истекло или его нет.
+Returns cached data by its URL, or nil, if life time of cached data has expired.
URL, закэшированные данные по которому необходимо получить
URL that corresponds to cached data
экземпляр класса NSData, закэшированные данные указанного URL
+instance of NSData class, cached data
Возвращает закэшированные данные по указанному URL, либо nil, если для данного -запроса нет кэша.
+Returns cached data by its URL, or nil, if life time of cached data has +expired or there is no data for current URL.
URL, закэшированные данные по которому необходимо получить
URL that corresponds to cached data
оффлайн режим запроса кэша (как работает описано в Обсуждении)
offline mode
экземпляр класса NSData, закэшированные данные указанного URL
+instance of NSData class, cached data which corresponds to received URL
Параметр offlineMode влияет на возвращаемые данные следующим образом: если передается -YES и в кэше есть данные для этого URL, но срок их жизни истек, то они всё равно -будут возвращены (без удаления, до последующего обновления). -Если параметр offlineMode равен NO, то при запросе данных из кэша, они будут -удалены в случае, если время жизни данных истекло.
- -Использование данного метода с передачей значения YES в параметре offlineMode -полезно при отсутствии интернет соединения.
+As you know, offlineMode can make current method return cached data even if its +life time expired. You should use offlineMode (YES) if there is no internet +connection.
Удаление всех закэшированных данных в директории, которой был инициализирован -данный объект
+Removes all cached data in a directory which were used for initialization.
Инициализация объекта для кэширования запросов
+Initialization methods
директория в которой должны будут храниться кэшируемые данные. -Если директория не существует, то будет создана.
directory where would be saved cached data. If there is no such +directory then it’s going to be created.
объект типа VKCache
+instance of VKCache
Удаление директории с данными кэша
+Removes directory with all cached data.
Удаление кэша указанного URL
+Removes cached data by its URL
URL, закэшированные данные которого необходимо удалить
URL that corresponds to cached data which needs to be removed
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-15)
+
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-20)
Generated by appledoc 2.1 (build 858).
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-15)
+
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-20)
Generated by appledoc 2.1 (build 858).
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-15)
+
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-20)
Generated by appledoc 2.1 (build 858).
Класс предназначен для управления запросами к серверу ВК.
+Current class gives possibility to perform requests to VK servers.
-Процент покрываемых методов: 100%
+The most updated information and documentation on methods you can get +from official VK Developers page: https://vk.com/dev/main
+ +Methods which are documented in Russian (in current file) won’t be translated +in English, so please refer to VK official English documentation.
+ +Methods covered: 100%.
user
- Пользователь от лица которого осуществляются запросы.
+User from whose face requests are made.
property delegate
- Делегат
+Delegate
property startAllRequestsImmediately
- Начинать ли выполнение запросов немедленно или предоставить программисту -самому выбирать момент запуска запроса. -По умолчанию принимает значение YES.
+Allows developer to initiate immediate request start after its being created. +Defaults to YES.
property offlineMode
- Оффлайн режим. В данном режиме данные будут запрошены из кэша и возвращены -даже в случае истечения срока их действия (удаления не произойдет). -По умолчанию режим выключен.
+Offline mode, works for all requests. Current mode is used to return cache data even +if its lifetime ended, no deletion occurs (use this mode if no internet connection exists).
property @@ -1419,14 +1423,14 @@– initWithDelegate:user:
- Инициализация менеджера запросов
+Designated initialization method.
@@ -1434,84 +1438,106 @@– notesGet:
- Возвращает список заметок, созданных пользователем.
+– searchGetHints:
+ Метод позволяет получить результаты быстрого поиска по произвольной подстроке
+ + + +– placesAdd:
+ Добавляет новое место в базу географических мест.
– notesGetByID:
- Возвращает заметку по её id
+– placesGetByID:
+ Возвращает информацию о местах по их идентификаторам.
– notesGetFriendsNotes:
- Возвращает список заметок друзей пользователя.
+– placesSearch:
+ Возвращает список мест, найденных по заданным условиям поиска.
– notesAdd:
- Создает новую заметку у текущего пользователя
+– placesCheckIn:
+ Отмечает пользователя в указанном месте.
– notesEdit:
- Редактирует заметку текущего пользователя.
+– placesGetCheckins:
+ Возвращает список отметок пользователей в местах согласно заданным параметрам.
– notesDelete:
- Удаляет заметку текущего пользователя
+– placesGetTypes:
+ Возвращает список всех возможных типов мест.
– notesGetComments:
- Возвращает список комментариев к заметке
+– placesGetContries:
+ Возвращает список стран.
– notesCreateComment:
- Добавляет новый комментарий к заметке
+– placesGetRegions:
+ Возвращает список регионов.
– notesEditComment:
- Редактирует указанный комментарий у заметки
+– placesGetStreetByID:
+ Возвращает информацию об улицах по их идентификаторам (id).
– notesDeleteComment:
- Удаляет комментарий к заметке
+– placesGetCountryByID:
+ Возвращает информацию о странах по их идентификаторам
– notesRestoreComment:
- Восстанавливает удалённый комментарий
+– placesGetCities:
+ Возвращает список городов.
+ + + +– placesGetCityByID:
+ Возвращает информацию о городах по их идентификаторам.
@@ -1519,246 +1545,253 @@– adsGetAccounts:
- Возвращает список рекламных кабинетов.
+– audioGet:
+ Возвращает список аудиозаписей пользователя или сообщества
– adsGetClients:
- Возвращает список клиентов рекламного агентства.
+– audioGetByID:
+ Возвращает информацию об аудиозаписях
– adsCreateClients:
- Создает клиентов рекламного агентства.
+– audioGetLyrics:
+ Возвращает текст аудиозаписи
– adsUpdateClients:
- Редактирует клиентов рекламного агентства. -Доступно только для рекламных агентств.
+– audioSearch:
+ Возвращает список аудиозаписей в соответствии с заданным критерием поиска
– adsDeleteClients:
- Архивирует клиентов рекламного агентства.
+– audioGetUploadServer:
+ Возвращает адрес сервера для загрузки аудиозаписей
– adsGetCampaigns:
- Возвращает список кампаний рекламного кабинета.
+– audioSave:
+ Сохраняет аудиозаписи после успешной загрузки
– adsCreateCampaigns:
- Создает рекламные кампании. -Внимание! Допустимое количество кампаний, создаваемых с помощью одного запроса — 50.
+– audioAdd:
+ Копирует аудиозапись на страницу пользователя или группы
– adsUpdateCampaings:
- Редактирует рекламные кампании.
+– audioDelete:
+ Удаляет аудиозапись со страницы пользователя или сообщества
– adsDeleteCampaings:
- Архивирует рекламные кампании.
+– audioEdit:
+ Редактирует данные аудиозаписи на странице пользователя или сообщества
– adsGet:
- Возвращает список рекламных объявлений.
+– audioReorder:
+ Изменяет порядок аудиозаписи, перенося ее между аудиозаписями, идентификаторы которых переданы параметрами after и before
– adsGetLayout:
- Возвращает описания внешнего вида рекламных объявлений.
+– audioRestore:
+ Восстанавливает аудиозапись после удаления
– adsGetTargeting:
- Возвращает параметры таргетинга рекламных объявлений
+– audioGetAlbums:
+ Возвращает список альбомов аудиозаписей пользователя или группы
– adsCreate:
- Создает рекламные объявления.
+– audioAddAlbum:
+ Создает пустой альбом аудиозаписей
– adsUpdate:
- Редактирует рекламные объявления.
+– audioEditAlbum:
+ Редактирует название альбома аудиозаписей
– adsDelete:
- Архивирует рекламные объявления.
+– audioDeleteAlbum:
+ Удаляет альбом аудиозаписей
– adsGetStatistics:
- Возвращает статистику показателей эффективности по рекламным объявлениям, -кампаниям, клиентам или всему кабинету.
+– audioMoveToAlbum:
+ Перемещает аудиозаписи в альбом
– adsGetDemographics:
- Возвращает демографическую статистику по рекламным объявлениям или кампаниям.
+– audioSetBroadcast:
+ Транслирует аудиозапись в статус пользователю или сообществу
– adsGetBudget:
- Возвращает текущий бюджет рекламного кабинета.
+– audioGetBroadcastList:
+ Возвращает список друзей и сообществ пользователя, которые транслируют музыку в статус
– adsGetOfficeUsers:
- Возвращает список администраторов и наблюдателей рекламного кабинета.
+– audioGetRecommendations:
+ Возвращает список рекомендуемых аудиозаписей на основе списка воспроизведения заданного пользователя или на основе одной выбранной аудиозаписи
– adsAddOfficeUsers:
- Добавляет администраторов и/или наблюдателей в рекламный кабинет.
+– audioGetPopular:
+ Возвращает список аудиозаписей из раздела “Популярное”
– adsRemoveOfficeUsers:
- Удаляет администраторов и/или наблюдателей из рекламного кабинета.
+– audioGetCount:
+ Возвращает количество аудиозаписей пользователя или сообщества
-– adsGetTargetingStats:
- Возвращает размер целевой аудитории таргетинга, а также рекомендованные -значения CPC и CPM.
+– boardGetTopics:
+ Возвращает список тем в обсуждениях указанной группы.
– adsGetSuggestions:
- Возвращает набор подсказок автодополнения для различных параметров таргетинга.
+– boardGetComments:
+ Возвращает список сообщений в указанной теме.
– adsGetCategories:
- Получение тематик объявлений.
+– boardAddTopic:
+ Создает новую тему в списке обсуждений группы.
– adsGetUploadURL:
- Возвращает URL-адрес для загрузки фотографии рекламного объявления.
+– boardAddComment:
+ Добавляет новое сообщение в теме сообщества.
– adsGetVideoUploadURL:
- Возвращает URL-адрес для загрузки видеозаписи рекламного объявления.
+– boardDeleteTopic:
+ Удаляет тему в обсуждениях группы
– adsGetFloodStats:
- Возвращает информацию о текущем состоянии счетчика — количество оставшихся -запусков методов и время до следующего обнуления счетчика в секундах.
+– boardEditTopic:
+ Изменяет заголовок темы в списке обсуждений группы
– adsGetRejectionReason:
- Возвращает причину, по которой указанному объявлению было отказано в -прохождении премодерации.
+– boardEditComment:
+ Редактирует одно из сообщений в теме группы
– adsCreateTargetGroup:
- Создает группу для ретаргетинга рекламных объявлений на пользователей, -которые посетили сайт рекламодателя (просмотрели информации о товаре, зарегистрировались и т.д.).
- +– boardRestoreComment:
+ Восстанавливает удаленное сообщение темы в обсуждениях группы
+– adsUpdateTargetGroup:
- Редактирует группу ретаргетинга.
+– boardDeleteComment:
+ Удаляет сообщение темы в обсуждениях сообщества
– adsDeleteTargetGroup:
- Удаляет группу ретаргетинга.
+– boardOpenTopic:
+ Открывает ранее закрытую тему (в ней станет возможно оставлять новые сообщения).
– adsGetTargetGroups:
- Возвращает список групп таргетирования.
+– boardCloseTopic:
+ Закрывает тему в списке обсуждений группы (в такой теме невозможно оставлять новые сообщения)
– adsImportTargetContacts:
- Импортирует список контактов рекламодателя для учета зарегистрированных во -ВКонтакте пользователей в срезе группы таргетирования.
+– boardFixTopic:
+ Закрепляет тему в списке обсуждений группы (такая тема при любой сортировке выводится выше остальных)
+ + + +– boardUnfixTopic:
+ Отменяет прикрепление темы в списке обсуждений группы (тема будет выводиться согласно выбранной сортировке)
@@ -1766,134 +1799,134 @@– pollsGetByID:
- Возвращает детальную информацию об опросе по его идентификатору.
+– pagesGet:
+ Возвращает информацию о вики-странице.
– pollsAddVote:
- Отдает голос текущего пользователя за выбранный вариант ответа в указанном опросе.
+– pagesSave:
+ Сохраняет текст вики-страницы.
– pollsDeleteVote:
- Снимает голос текущего пользователя с выбранного варианта ответа в указанном опросе.
+– pagesSaveAccess:
+ Сохраняет новые настройки доступа на чтение и редактирование вики-страницы.
– pollsGetVoters:
- Получает список идентификаторов пользователей, которые выбрали определенные варианты ответа в опросе.
+– pagesGetHistory:
+ Возвращает список всех старых версий вики-страницы.
-– accountGetCounters:
- Возвращает ненулевые значения счетчиков пользователя
+– pagesGetTitles:
+ Возвращает список вики-страниц в группе.
– accountSetNameInMenu:
- Устанавливает короткое название приложения (до 17 символов), которое выводится пользователю в левом меню.
+– pagesGetVersion:
+ Возвращает текст одной из старых версий страницы.
– accountSetOnline:
- Помечает текущего пользователя как online на 15 минут.
+– pagesParseWiki:
+ Возвращает html-представление вики-разметки
-– accountImportContacts:
- Принимает список контактов пользователя для поиска зарегистрированных во ВКонтакте пользователей методом friends.getSuggestions.
+– newsfeedGet:
+ Возвращает данные, необходимые для показа списка новостей для текущего пользователя
– accountRegisterDevice:
- Подписывает устройство на базе iOS, Android иди Windows Phone на получение Push-уведомлений.
+– newsfeedGetRecommended:
+ Получает список новостей, рекомендованных пользователю
– accountUnregisterDevice:
- Отписывает устройство от Push уведомлений.
+– newsfeedGetComments:
+ Возвращает данные, необходимые для показа раздела комментариев в новостях пользователя
– accountSetSilenceMode:
- Отключает push-уведомления на заданный промежуток времени.
+– newsfeedGetMentions:
+ Возвращает список записей пользователей на своих стенах, в которых упоминается указанный пользователь
– accountGetPushSettings:
- Позволяет получать настройки Push уведомлений.
+– newsfeedGetBanned:
+ Возвращает список пользователей и групп, которые текущий пользователь скрыл из ленты новостей
– accountGetAppPermissions:
- Получает настройки текущего пользователя в данном приложении.
+– newsfeedAddBan:
+ Запрещает показывать новости от заданных пользователей и групп в ленте новостей текущего пользователя
– accountGetActiveOffers:
- Возвращает список активных рекламных предложений (офферов), выполнив которые пользователь сможет получить соответствующее количество голосов на свой счёт внутри приложения.
+– newsfeedDeleteBan:
+ Разрешает показывать новости от заданных пользователей и групп в ленте новостей текущего пользователя
– accountBanUser:
- Добавляет пользователя в черный список.
+– newsfeedSearch:
+ Возвращает результаты поиска по статусам
– accountUnbanUser:
- Убирает пользователя из черного списка.
+– newsfeedGetLists:
+ Возвращает пользовательские списки новостей
– accountGetBanned:
- Возвращает список пользователей, находящихся в черном списке.
+– newsfeedUnsubscribe:
+ Отписывает текущего пользователя от комментариев к заданному объекту
@@ -1901,56 +1934,35 @@– pagesGet:
- Возвращает информацию о вики-странице.
- - - -– pagesSave:
- Сохраняет текст вики-страницы.
- - - -– pagesSaveAccess:
- Сохраняет новые настройки доступа на чтение и редактирование вики-страницы.
- - - -– pagesGetHistory:
- Возвращает список всех старых версий вики-страницы.
+– likesGetList:
+ Получает список идентификаторов пользователей, которые добавили заданный объект в свой список Мне нравится.
– pagesGetTitles:
- Возвращает список вики-страниц в группе.
+– likesAdd:
+ Добавляет указанный объект в список Мне нравится текущего пользователя
– pagesGetVersion:
- Возвращает текст одной из старых версий страницы.
+– likesDelete:
+ Удаляет указанный объект из списка Мне нравится текущего пользователя
– pagesParseWiki:
- Возвращает html-представление вики-разметки
+– likesIsLiked:
+ Проверяет, находится ли объект в списке Мне нравится заданного пользователя.
@@ -1958,277 +1970,246 @@– appsGetCatalog:
- Возвращает список приложений, доступных для пользователей сайта через каталог приложений.
+– adsGetAccounts:
+ Возвращает список рекламных кабинетов.
-– databaseGetCountries:
- Возвращает список стран.
+– adsGetClients:
+ Возвращает список клиентов рекламного агентства.
– databaseGetRegions:
- Возвращает список регионов.
+– adsCreateClients:
+ Создает клиентов рекламного агентства.
– databaseGetStreetsById:
- Возвращает информацию об улицах по их идентификаторам (id).
+– adsUpdateClients:
+ Редактирует клиентов рекламного агентства. +Доступно только для рекламных агентств.
– databaseGetCountriesById:
- Возвращает информацию о странах по их идентификаторам
+– adsDeleteClients:
+ Архивирует клиентов рекламного агентства.
– databaseGetCities:
- Возвращает список городов.
+– adsGetCampaigns:
+ Возвращает список кампаний рекламного кабинета.
– databaseGetCitiesById:
- Возвращает информацию о городах по их идентификаторам.
+– adsCreateCampaigns:
+ Создает рекламные кампании. +Внимание! Допустимое количество кампаний, создаваемых с помощью одного запроса — 50.
– databaseGetUniversities:
- Возвращает список высших учебных заведений.
+– adsUpdateCampaings:
+ Редактирует рекламные кампании.
– databaseGetSchools:
- Возвращает список школ.
+– adsDeleteCampaings:
+ Архивирует рекламные кампании.
– databaseGetFaculties:
- Возвращает список факультетов.
+– adsGet:
+ Возвращает список рекламных объявлений.
-– placesAdd:
- Добавляет новое место в базу географических мест.
+– adsGetLayout:
+ Возвращает описания внешнего вида рекламных объявлений.
– placesGetByID:
- Возвращает информацию о местах по их идентификаторам.
+– adsGetTargeting:
+ Возвращает параметры таргетинга рекламных объявлений
– placesSearch:
- Возвращает список мест, найденных по заданным условиям поиска.
+– adsCreate:
+ Создает рекламные объявления.
– placesCheckIn:
- Отмечает пользователя в указанном месте.
+– adsUpdate:
+ Редактирует рекламные объявления.
– placesGetCheckins:
- Возвращает список отметок пользователей в местах согласно заданным параметрам.
+– adsDelete:
+ Архивирует рекламные объявления.
– placesGetTypes:
- Возвращает список всех возможных типов мест.
+– adsGetStatistics:
+ Возвращает статистику показателей эффективности по рекламным объявлениям, +кампаниям, клиентам или всему кабинету.
– placesGetContries:
- Возвращает список стран.
+– adsGetDemographics:
+ Возвращает демографическую статистику по рекламным объявлениям или кампаниям.
– placesGetRegions:
- Возвращает список регионов.
+– adsGetBudget:
+ Возвращает текущий бюджет рекламного кабинета.
– placesGetStreetByID:
- Возвращает информацию об улицах по их идентификаторам (id).
+– adsGetOfficeUsers:
+ Возвращает список администраторов и наблюдателей рекламного кабинета.
– placesGetCountryByID:
- Возвращает информацию о странах по их идентификаторам
+– adsAddOfficeUsers:
+ Добавляет администраторов и/или наблюдателей в рекламный кабинет.
– placesGetCities:
- Возвращает список городов.
+– adsRemoveOfficeUsers:
+ Удаляет администраторов и/или наблюдателей из рекламного кабинета.
– placesGetCityByID:
- Возвращает информацию о городах по их идентификаторам.
- - - -– newsfeedGet:
- Возвращает данные, необходимые для показа списка новостей для текущего пользователя
+– adsGetTargetingStats:
+ Возвращает размер целевой аудитории таргетинга, а также рекомендованные +значения CPC и CPM.
– newsfeedGetRecommended:
- Получает список новостей, рекомендованных пользователю
+– adsGetSuggestions:
+ Возвращает набор подсказок автодополнения для различных параметров таргетинга.
– newsfeedGetComments:
- Возвращает данные, необходимые для показа раздела комментариев в новостях пользователя
+– adsGetCategories:
+ Получение тематик объявлений.
– newsfeedGetMentions:
- Возвращает список записей пользователей на своих стенах, в которых упоминается указанный пользователь
+– adsGetUploadURL:
+ Возвращает URL-адрес для загрузки фотографии рекламного объявления.
– newsfeedGetBanned:
- Возвращает список пользователей и групп, которые текущий пользователь скрыл из ленты новостей
+– adsGetVideoUploadURL:
+ Возвращает URL-адрес для загрузки видеозаписи рекламного объявления.
– newsfeedAddBan:
- Запрещает показывать новости от заданных пользователей и групп в ленте новостей текущего пользователя
+– adsGetFloodStats:
+ Возвращает информацию о текущем состоянии счетчика — количество оставшихся +запусков методов и время до следующего обнуления счетчика в секундах.
– newsfeedDeleteBan:
- Разрешает показывать новости от заданных пользователей и групп в ленте новостей текущего пользователя
+– adsGetRejectionReason:
+ Возвращает причину, по которой указанному объявлению было отказано в +прохождении премодерации.
– newsfeedSearch:
- Возвращает результаты поиска по статусам
+– adsCreateTargetGroup:
+ Создает группу для ретаргетинга рекламных объявлений на пользователей, +которые посетили сайт рекламодателя (просмотрели информации о товаре, зарегистрировались и т.д.).
– newsfeedGetLists:
- Возвращает пользовательские списки новостей
+– adsUpdateTargetGroup:
+ Редактирует группу ретаргетинга.
– newsfeedUnsubscribe:
- Отписывает текущего пользователя от комментариев к заданному объекту
+– adsDeleteTargetGroup:
+ Удаляет группу ретаргетинга.
-– statusGet:
- Получает текст статуса пользователя или сообщества.
+– adsGetTargetGroups:
+ Возвращает список групп таргетирования.
– statusSet:
- Устанавливает новый статус текущему пользователю.
+– adsImportTargetContacts:
+ Импортирует список контактов рекламодателя для учета зарегистрированных во +ВКонтакте пользователей в срезе группы таргетирования.
@@ -2236,56 +2217,23 @@– docsGet:
- Возвращает расширенную информацию о документах пользователя или сообщества.
- - - -– docsGetByID:
- Возвращает информацию о документах по их идентификаторам.
- - - -– docsGetUploadServer:
- Возвращает адрес сервера для загрузки документов.
- - - -– docsGetWallUploadServer:
- Возвращает адрес сервера для загрузки документов в папку Отправленные, для последующей отправки документа на стену или личным сообщением.
- - - -– docsSave:
- Сохраняет документ после его успешной загрузки на сервер.
- - - -– docsDelete:
- Удаляет документ пользователя или группы
+– execute:
+ Универсальный метод, который позволяет запускать последовательность других +методов, сохраняя и фильтруя промежуточные результаты.
– docsAdd:
- Копирует документ в документы текущего пользователя
+– executePredefinedProcedureWithName:options:
+ Хранимые процедуры позволяют исполнять код на стороне сервера API аналогично +методу execute, но без передачи кода процедуры по сети.
@@ -2293,49 +2241,14 @@– info
- Информация о текущем пользователе.
- - - -– info:
- Информация о пользователе(ях) с указанными параметрами
- - - -– search:
- Возвращает список пользователей в соответствии с заданным критерием поиска
- - - -– subscriptions:
- Возвращает список идентификаторов пользователей и групп, которые входят в список подписок пользователя
- - - -– followers:
- Возвращает список идентификаторов пользователей, которые являются подписчиками пользователя. Идентификаторы пользователей в списке отсортированы в порядке убывания времени их добавления.
- - - -– isAppUser:
- Возвращает информацию о том, установил ли пользователь приложение.
+– appsGetCatalog:
+ Возвращает список приложений, доступных для пользователей сайта через каталог приложений.
@@ -2428,266 +2341,336 @@– photosCreateAlbum:
- Создает пустой альбом для фотографий
+– info
+ Информация о текущем пользователе.
– photosEditAlbum:
- Редактирует данные альбома для фотографий пользователя
+– info:
+ Информация о пользователе(ях) с указанными параметрами
– photosGetAlbums:
- Возвращает список альбомов пользователя или сообщества
+– search:
+ Возвращает список пользователей в соответствии с заданным критерием поиска
– photosGet:
- Возвращает список фотографий в альбоме
+– subscriptions:
+ Возвращает список идентификаторов пользователей и групп, которые входят в список подписок пользователя
– photosGetAlbumsCount:
- Возвращает количество доступных альбомов пользователя
+– followers:
+ Возвращает список идентификаторов пользователей, которые являются подписчиками пользователя. Идентификаторы пользователей в списке отсортированы в порядке убывания времени их добавления.
– photosGetProfile:
- Возвращает список фотографий со страницы пользователя или сообщества
+– isAppUser:
+ Возвращает информацию о том, установил ли пользователь приложение.
-– photosGetByID:
- Возвращает информацию о фотографиях по их идентификаторам
+– notificationsGet:
+ Возвращает список оповещений об ответах других пользователей на записи текущего пользователя.
– photosGetUploadServer:
- Возвращает адрес сервера для загрузки фотографий
+– notificationsMarkeAsViewed:
+ Сбрасывает счетчик непросмотренных оповещений об ответах других пользователей на записи текущего пользователя.
-– photosGetProfileUploadServer:
- Возвращает адрес сервера для загрузки фотографии на страницу пользователя
+– pollsGetByID:
+ Возвращает детальную информацию об опросе по его идентификатору.
– photosGetChatUploadServer:
- Позволяет получить адрес для загрузки фотографий мультидиалогов
+– pollsAddVote:
+ Отдает голос текущего пользователя за выбранный вариант ответа в указанном опросе.
– photosSaveProfilePhoto:
- Сохраняет фотографию пользователя после успешной загрузки
+– pollsDeleteVote:
+ Снимает голос текущего пользователя с выбранного варианта ответа в указанном опросе.
– photosSaveWallPhoto:
- Сохраняет фотографии после успешной загрузки на URI, полученный методом photos.getWallUploadServer
- +– pollsGetVoters:
+ Получает список идентификаторов пользователей, которые выбрали определенные варианты ответа в опросе.
+ -– photosGetWallUploadServer:
- Возвращает адрес сервера для загрузки фотографии на стену пользователя.
+– statsGet:
+ Возвращает статистику сообщества или приложения.
+ + + +– utilsCheckLink:
+ Возвращает информацию о том, является ли ссылка заблокированной на сайте ВКонтакте.
– photosGetMessagesUploadServer:
- Возвращает адрес сервера для загрузки фотографии в личное сообщение пользователю
+– utilsResolveScreenName:
+ Определяет тип объекта (пользователь, сообщество, приложение) и его +идентификатор по короткому имени screen_name.
– photosSaveMessagesPhoto:
- Сохраняет фотографию после успешной загрузки на URI, полученный методом photos.getMessagesUploadServer
+– utilsGetServerTime:
+ Возвращает текущее время на сервере ВКонтакте в unixtime.
+ + + +– friendsGet:
+ Возвращает список идентификаторов друзей пользователя или расширенную информацию о друзьях пользователя (при использовании параметра fields)
– photosSearch:
- Осуществляет поиск изображений по местоположению или описанию
+– friendsGetOnline:
+ Возвращает список идентификаторов друзей пользователя, находящихся на сайте
– photosSave:
- Сохраняет фотографии после успешной загрузки
+– friendsGetMutual:
+ Возвращает список идентификаторов общих друзей между парой пользователей
– photosEdit:
- Изменяет описание у выбранной фотографии
+– friendsGetRecent:
+ Возвращает список идентификаторов недавно добавленных друзей текущего пользователя
– photosMove:
- Переносит фотографию из одного альбома в другой
+– friendsGetRequests:
+ Возвращает информацию о полученных или отправленных заявках на добавление в друзья для текущего пользователя
– photosMakeCover:
- Делает фотографию обложкой альбома
+– friendsAdd:
+ Одобряет или создает заявку на добавление в друзья.
– photosReorderAlbums:
- Меняет порядок альбома в списке альбомов пользователя
+– friendsEdit:
+ Редактирует списки друзей для выбранного друга
– photosReorderPhotos:
- Меняет порядок фотографии в списке фотографий альбома пользователя
+– friendsDelete:
+ Удаляет пользователя из списка друзей или отклоняет заявку в друзья
– photosGetAll:
- Возвращает все фотографии пользователя или сообщества в антихронологическом порядке
+– friendsGetLists:
+ Возвращает список меток друзей текущего пользователя
– photosGetUserPhotos:
- Возвращает список фотографий, на которых отмечен пользователь
+– friendsAddList:
+ Создает новый список друзей у текущего пользователя
– photosDeleteAlbum:
- Удаляет указанный альбом для фотографий у текущего пользователя
+– friendsEditList:
+ Редактирует существующий список друзей текущего пользователя
– photosDelete:
- Удаление фотографии на сайте
+– friendsDeleteList:
+ Удаляет существующий список друзей текущего пользователя
– photosConfirmTagWithCustomOptions:
- Подтверждает отметку на фотографии
+– friendsGetAppUsers:
+ Возвращает список идентификаторов друзей текущего пользователя, которые установили данное приложение
– photosGetComments:
- Возвращает список комментариев к фотографии
+– friendsGetByPhones:
+ Возвращает список друзей пользователя, у которых завалидированные или указанные в профиле телефонные номера входят в заданный список.
– photosGetAllComments:
- Возвращает отсортированный в антихронологическом порядке список всех комментариев к конкретному альбому или ко всем альбомам пользователя
+– friendsDeleteAllRequests:
+ Отмечает все входящие заявки на добавление в друзья как просмотренные
– photosCreateComment:
- Создает новый комментарий к фотографии
+– friendsGetSuggestions:
+ Возвращает список профилей пользователей, которые могут быть друзьями текущего пользователя.
– photosDeleteComment:
- Удаляет комментарий к фотографии
+– friendsAreFriends:
+ Возвращает информацию о том, добавлен ли текущий пользователь в друзья у указанных пользователей.
+ + + +– docsGet:
+ Возвращает расширенную информацию о документах пользователя или сообщества.
– photosRestoreComment:
- Восстанавливает удаленный комментарий к фотографии
+– docsGetByID:
+ Возвращает информацию о документах по их идентификаторам.
– photosEditComment:
- Изменяет текст комментария к фотографии
+– docsGetUploadServer:
+ Возвращает адрес сервера для загрузки документов.
– photosGetTags:
- Возвращает список отметок на фотографии
+– docsGetWallUploadServer:
+ Возвращает адрес сервера для загрузки документов в папку Отправленные, для последующей отправки документа на стену или личным сообщением.
– photosPutTag:
- Добавляет отметку на фотографию
+– docsSave:
+ Сохраняет документ после его успешной загрузки на сервер.
– photosRemoveTag:
- Удаляет отметку с фотографии
+– docsDelete:
+ Удаляет документ пользователя или группы
– photosGetNewTags:
- Возвращает список фотографий, на которых есть непросмотренные отметки
+– docsAdd:
+ Копирует документ в документы текущего пользователя
@@ -2695,145 +2678,155 @@– statsGet:
- Возвращает статистику сообщества или приложения.
+– databaseGetCountries:
+ Возвращает список стран.
-– wallGet:
- Возвращает список записей со стены пользователя или сообщества
+– databaseGetRegions:
+ Возвращает список регионов.
– wallGetByID:
- Возвращает список записей со стен пользователей по их идентификаторам
+– databaseGetStreetsById:
+ Возвращает информацию об улицах по их идентификаторам (id).
– wallSavePost:
- Сохраняет запись на стене пользователя. Запись может содержать фотографию, ранее загруженную на сервер ВКонтакте, или любую доступную фотографию из альбома пользователя. -При запуске со стены приложение открывается в окне размером 607x412 и ему передаются параметры, описанные здесь.
+– databaseGetCountriesById:
+ Возвращает информацию о странах по их идентификаторам
– wallPost:
- Публикует новую запись на своей или чужой стене. -Данный метод позволяет создать новую запись на стене, а также опубликовать предложенную новость или отложенную запись.
+– databaseGetCities:
+ Возвращает список городов.
– wallRepost:
- Копирует объект на стену пользователя или сообщества
+– databaseGetCitiesById:
+ Возвращает информацию о городах по их идентификаторам.
– wallGetReposts:
- Позволяет получать список репостов заданной записи
+– databaseGetUniversities:
+ Возвращает список высших учебных заведений.
– wallEdit:
- Редактирует запись на стене
+– databaseGetSchools:
+ Возвращает список школ.
– wallDelete:
- Удаляет запись со стены
+– databaseGetFaculties:
+ Возвращает список факультетов.
+ + + +– notesGet:
+ Возвращает список заметок, созданных пользователем.
– wallRestore:
- Восстанавливает удаленную запись на стене пользователя
+– notesGetByID:
+ Возвращает заметку по её id
– wallGetComments:
- Возвращает список комментариев к записи на стене пользователя
+– notesGetFriendsNotes:
+ Возвращает список заметок друзей пользователя.
– wallAddComment:
- Добавляет комментарий к записи на стене пользователя или сообщества
+– notesAdd:
+ Создает новую заметку у текущего пользователя
– wallDeleteComment:
- Удаляет комментарий текущего пользователя к записи на своей или чужой стене
+– notesEdit:
+ Редактирует заметку текущего пользователя.
– wallRestoreComment:
- Восстанавливает комментарий текущего пользователя к записи на своей или чужой стене
+– notesDelete:
+ Удаляет заметку текущего пользователя
+ + + +– notesGetComments:
+ Возвращает список комментариев к заметке
+ + + +– notesCreateComment:
+ Добавляет новый комментарий к заметке
-– utilsCheckLink:
- Возвращает информацию о том, является ли ссылка заблокированной на сайте ВКонтакте.
+– notesEditComment:
+ Редактирует указанный комментарий у заметки
– utilsResolveScreenName:
- Определяет тип объекта (пользователь, сообщество, приложение) и его -идентификатор по короткому имени screen_name.
+– notesDeleteComment:
+ Удаляет комментарий к заметке
– utilsGetServerTime:
- Возвращает текущее время на сервере ВКонтакте в unixtime.
+– notesRestoreComment:
+ Восстанавливает удалённый комментарий
@@ -3010,21 +3003,100 @@– notificationsGet:
- Возвращает список оповещений об ответах других пользователей на записи текущего пользователя.
+– wallGet:
+ Возвращает список записей со стены пользователя или сообщества
– notificationsMarkeAsViewed:
- Сбрасывает счетчик непросмотренных оповещений об ответах других пользователей на записи текущего пользователя.
+– wallGetByID:
+ Возвращает список записей со стен пользователей по их идентификаторам
+ + + +– wallSavePost:
+ Сохраняет запись на стене пользователя. Запись может содержать фотографию, ранее загруженную на сервер ВКонтакте, или любую доступную фотографию из альбома пользователя. +При запуске со стены приложение открывается в окне размером 607x412 и ему передаются параметры, описанные здесь.
+ + + +– wallPost:
+ Публикует новую запись на своей или чужой стене. +Данный метод позволяет создать новую запись на стене, а также опубликовать предложенную новость или отложенную запись.
+ + + +– wallRepost:
+ Копирует объект на стену пользователя или сообщества
+ + + +– wallGetReposts:
+ Позволяет получать список репостов заданной записи
+ + + +– wallEdit:
+ Редактирует запись на стене
+ + + +– wallDelete:
+ Удаляет запись со стены
+ + + +– wallRestore:
+ Восстанавливает удаленную запись на стене пользователя
+ + + +– wallGetComments:
+ Возвращает список комментариев к записи на стене пользователя
+ + + +– wallAddComment:
+ Добавляет комментарий к записи на стене пользователя или сообщества
+ + + +– wallDeleteComment:
+ Удаляет комментарий текущего пользователя к записи на своей или чужой стене
+ + + +– wallRestoreComment:
+ Восстанавливает комментарий текущего пользователя к записи на своей или чужой стене
@@ -3032,98 +3104,98 @@– boardGetTopics:
- Возвращает список тем в обсуждениях указанной группы.
+– accountGetCounters:
+ Возвращает ненулевые значения счетчиков пользователя
– boardGetComments:
- Возвращает список сообщений в указанной теме.
+– accountSetNameInMenu:
+ Устанавливает короткое название приложения (до 17 символов), которое выводится пользователю в левом меню.
– boardAddTopic:
- Создает новую тему в списке обсуждений группы.
+– accountSetOnline:
+ Помечает текущего пользователя как online на 15 минут.
– boardAddComment:
- Добавляет новое сообщение в теме сообщества.
+– accountImportContacts:
+ Принимает список контактов пользователя для поиска зарегистрированных во ВКонтакте пользователей методом friends.getSuggestions.
– boardDeleteTopic:
- Удаляет тему в обсуждениях группы
+– accountRegisterDevice:
+ Подписывает устройство на базе iOS, Android иди Windows Phone на получение Push-уведомлений.
– boardEditTopic:
- Изменяет заголовок темы в списке обсуждений группы
+– accountUnregisterDevice:
+ Отписывает устройство от Push уведомлений.
– boardEditComment:
- Редактирует одно из сообщений в теме группы
+– accountSetSilenceMode:
+ Отключает push-уведомления на заданный промежуток времени.
– boardRestoreComment:
- Восстанавливает удаленное сообщение темы в обсуждениях группы
+– accountGetPushSettings:
+ Позволяет получать настройки Push уведомлений.
– boardDeleteComment:
- Удаляет сообщение темы в обсуждениях сообщества
+– accountGetAppPermissions:
+ Получает настройки текущего пользователя в данном приложении.
– boardOpenTopic:
- Открывает ранее закрытую тему (в ней станет возможно оставлять новые сообщения).
+– accountGetActiveOffers:
+ Возвращает список активных рекламных предложений (офферов), выполнив которые пользователь сможет получить соответствующее количество голосов на свой счёт внутри приложения.
– boardCloseTopic:
- Закрывает тему в списке обсуждений группы (в такой теме невозможно оставлять новые сообщения)
+– accountBanUser:
+ Добавляет пользователя в черный список.
– boardFixTopic:
- Закрепляет тему в списке обсуждений группы (такая тема при любой сортировке выводится выше остальных)
+– accountUnbanUser:
+ Убирает пользователя из черного списка.
– boardUnfixTopic:
- Отменяет прикрепление темы в списке обсуждений группы (тема будет выводиться согласно выбранной сортировке)
+– accountGetBanned:
+ Возвращает список пользователей, находящихся в черном списке.
@@ -3270,122 +3342,43 @@– messagesSearchDialogs:
- Возвращает список найденных диалогов текущего пользователя по введенной строке поиска
- - - -– messagesAddChatUser:
- Добавляет в мультидиалог нового пользователя
- - - -– messagesRemoveChatUser:
- Исключает из мультидиалога пользователя, если текущий пользователь был создателем беседы либо пригласил исключаемого пользователя
- - - -– messagesGetLastActivity:
- Возвращает текущий статус и дату последней активности указанного пользователя
- - - -– messagesSetChatPhoto:
- Позволяет установить фотографию мультидиалога, загруженную с помощью метода photos.getChatUploadServer
- - - -– messagesDeleteChatPhoto:
- Позволяет удалить фотографию мультидиалога
- - - -– likesGetList:
- Получает список идентификаторов пользователей, которые добавили заданный объект в свой список Мне нравится.
- - - -– likesAdd:
- Добавляет указанный объект в список Мне нравится текущего пользователя
- - - -– likesDelete:
- Удаляет указанный объект из списка Мне нравится текущего пользователя
- - - -– likesIsLiked:
- Проверяет, находится ли объект в списке Мне нравится заданного пользователя.
- - - -– messagesSearchDialogs:
+ Возвращает список найденных диалогов текущего пользователя по введенной строке поиска
+ + + +– faveGetUsers:
- Возвращает список пользователей, добавленных текущим пользователем в закладки.
+– messagesAddChatUser:
+ Добавляет в мультидиалог нового пользователя
– faveGetPhotos:
- Возвращает фотографии, на которых текущий пользователь поставил отметку “Мне нравится”
+– messagesRemoveChatUser:
+ Исключает из мультидиалога пользователя, если текущий пользователь был создателем беседы либо пригласил исключаемого пользователя
– faveGetPosts:
- Возвращает записи, на которых текущий пользователь поставил отметку «Мне нравится»
+– messagesGetLastActivity:
+ Возвращает текущий статус и дату последней активности указанного пользователя
– faveGetVideos:
- Возвращает список видеозаписей, на которых текущий пользователь поставил отметку «Мне нравится»
+– messagesSetChatPhoto:
+ Позволяет установить фотографию мультидиалога, загруженную с помощью метода photos.getChatUploadServer
– faveGetLinks:
- Возвращает ссылки, добавленные в закладки текущим пользователем.
+– messagesDeleteChatPhoto:
+ Позволяет удалить фотографию мультидиалога
@@ -3393,23 +3386,21 @@– execute:
- Универсальный метод, который позволяет запускать последовательность других -методов, сохраняя и фильтруя промежуточные результаты.
+– statusGet:
+ Получает текст статуса пользователя или сообщества.
– executePredefinedProcedureWithName:options:
- Хранимые процедуры позволяют исполнять код на стороне сервера API аналогично -методу execute, но без передачи кода процедуры по сети.
+– statusSet:
+ Устанавливает новый статус текущему пользователю.
@@ -3417,296 +3408,309 @@– friendsGet:
- Возвращает список идентификаторов друзей пользователя или расширенную информацию о друзьях пользователя (при использовании параметра fields)
+– photosCreateAlbum:
+ Создает пустой альбом для фотографий
– friendsGetOnline:
- Возвращает список идентификаторов друзей пользователя, находящихся на сайте
+– photosEditAlbum:
+ Редактирует данные альбома для фотографий пользователя
– friendsGetMutual:
- Возвращает список идентификаторов общих друзей между парой пользователей
+– photosGetAlbums:
+ Возвращает список альбомов пользователя или сообщества
– friendsGetRecent:
- Возвращает список идентификаторов недавно добавленных друзей текущего пользователя
+– photosGet:
+ Возвращает список фотографий в альбоме
– friendsGetRequests:
- Возвращает информацию о полученных или отправленных заявках на добавление в друзья для текущего пользователя
+– photosGetAlbumsCount:
+ Возвращает количество доступных альбомов пользователя
– friendsAdd:
- Одобряет или создает заявку на добавление в друзья.
+– photosGetProfile:
+ Возвращает список фотографий со страницы пользователя или сообщества
– friendsEdit:
- Редактирует списки друзей для выбранного друга
+– photosGetByID:
+ Возвращает информацию о фотографиях по их идентификаторам
– friendsDelete:
- Удаляет пользователя из списка друзей или отклоняет заявку в друзья
+– photosGetUploadServer:
+ Возвращает адрес сервера для загрузки фотографий
– friendsGetLists:
- Возвращает список меток друзей текущего пользователя
+– photosGetProfileUploadServer:
+ Возвращает адрес сервера для загрузки фотографии на страницу пользователя
– friendsAddList:
- Создает новый список друзей у текущего пользователя
+– photosGetChatUploadServer:
+ Позволяет получить адрес для загрузки фотографий мультидиалогов
– friendsEditList:
- Редактирует существующий список друзей текущего пользователя
+– photosSaveProfilePhoto:
+ Сохраняет фотографию пользователя после успешной загрузки
– friendsDeleteList:
- Удаляет существующий список друзей текущего пользователя
+– photosSaveWallPhoto:
+ Сохраняет фотографии после успешной загрузки на URI, полученный методом photos.getWallUploadServer
– friendsGetAppUsers:
- Возвращает список идентификаторов друзей текущего пользователя, которые установили данное приложение
+– photosGetWallUploadServer:
+ Возвращает адрес сервера для загрузки фотографии на стену пользователя.
– friendsGetByPhones:
- Возвращает список друзей пользователя, у которых завалидированные или указанные в профиле телефонные номера входят в заданный список.
+– photosGetMessagesUploadServer:
+ Возвращает адрес сервера для загрузки фотографии в личное сообщение пользователю
– friendsDeleteAllRequests:
- Отмечает все входящие заявки на добавление в друзья как просмотренные
+– photosSaveMessagesPhoto:
+ Сохраняет фотографию после успешной загрузки на URI, полученный методом photos.getMessagesUploadServer
– friendsGetSuggestions:
- Возвращает список профилей пользователей, которые могут быть друзьями текущего пользователя.
+– photosSearch:
+ Осуществляет поиск изображений по местоположению или описанию
– friendsAreFriends:
- Возвращает информацию о том, добавлен ли текущий пользователь в друзья у указанных пользователей.
+– photosSave:
+ Сохраняет фотографии после успешной загрузки
-– searchGetHints:
- Метод позволяет получить результаты быстрого поиска по произвольной подстроке
+– photosEdit:
+ Изменяет описание у выбранной фотографии
-– audioGet:
- Возвращает список аудиозаписей пользователя или сообщества
+– photosMove:
+ Переносит фотографию из одного альбома в другой
– audioGetByID:
- Возвращает информацию об аудиозаписях
+– photosMakeCover:
+ Делает фотографию обложкой альбома
– audioGetLyrics:
- Возвращает текст аудиозаписи
+– photosReorderAlbums:
+ Меняет порядок альбома в списке альбомов пользователя
– audioSearch:
- Возвращает список аудиозаписей в соответствии с заданным критерием поиска
+– photosReorderPhotos:
+ Меняет порядок фотографии в списке фотографий альбома пользователя
– audioGetUploadServer:
- Возвращает адрес сервера для загрузки аудиозаписей
+– photosGetAll:
+ Возвращает все фотографии пользователя или сообщества в антихронологическом порядке
– audioSave:
- Сохраняет аудиозаписи после успешной загрузки
+– photosGetUserPhotos:
+ Возвращает список фотографий, на которых отмечен пользователь
– audioAdd:
- Копирует аудиозапись на страницу пользователя или группы
+– photosDeleteAlbum:
+ Удаляет указанный альбом для фотографий у текущего пользователя
– audioDelete:
- Удаляет аудиозапись со страницы пользователя или сообщества
+– photosDelete:
+ Удаление фотографии на сайте
– audioEdit:
- Редактирует данные аудиозаписи на странице пользователя или сообщества
+– photosConfirmTagWithCustomOptions:
+ Подтверждает отметку на фотографии
– audioReorder:
- Изменяет порядок аудиозаписи, перенося ее между аудиозаписями, идентификаторы которых переданы параметрами after и before
+– photosGetComments:
+ Возвращает список комментариев к фотографии
– audioRestore:
- Восстанавливает аудиозапись после удаления
+– photosGetAllComments:
+ Возвращает отсортированный в антихронологическом порядке список всех комментариев к конкретному альбому или ко всем альбомам пользователя
– audioGetAlbums:
- Возвращает список альбомов аудиозаписей пользователя или группы
+– photosCreateComment:
+ Создает новый комментарий к фотографии
– audioAddAlbum:
- Создает пустой альбом аудиозаписей
+– photosDeleteComment:
+ Удаляет комментарий к фотографии
– audioEditAlbum:
- Редактирует название альбома аудиозаписей
+– photosRestoreComment:
+ Восстанавливает удаленный комментарий к фотографии
– audioDeleteAlbum:
- Удаляет альбом аудиозаписей
+– photosEditComment:
+ Изменяет текст комментария к фотографии
– audioMoveToAlbum:
- Перемещает аудиозаписи в альбом
+– photosGetTags:
+ Возвращает список отметок на фотографии
– audioSetBroadcast:
- Транслирует аудиозапись в статус пользователю или сообществу
+– photosPutTag:
+ Добавляет отметку на фотографию
– audioGetBroadcastList:
- Возвращает список друзей и сообществ пользователя, которые транслируют музыку в статус
+– photosRemoveTag:
+ Удаляет отметку с фотографии
– audioGetRecommendations:
- Возвращает список рекомендуемых аудиозаписей на основе списка воспроизведения заданного пользователя или на основе одной выбранной аудиозаписи
+– photosGetNewTags:
+ Возвращает список фотографий, на которых есть непросмотренные отметки
+ + + +– faveGetUsers:
+ Возвращает список пользователей, добавленных текущим пользователем в закладки.
– audioGetPopular:
- Возвращает список аудиозаписей из раздела “Популярное”
+– faveGetPhotos:
+ Возвращает фотографии, на которых текущий пользователь поставил отметку “Мне нравится”
– audioGetCount:
- Возвращает количество аудиозаписей пользователя или сообщества
+– faveGetPosts:
+ Возвращает записи, на которых текущий пользователь поставил отметку «Мне нравится»
+ + + +– faveGetVideos:
+ Возвращает список видеозаписей, на которых текущий пользователь поставил отметку «Мне нравится»
+ + + +– faveGetLinks:
+ Возвращает ссылки, добавленные в закладки текущим пользователем.
@@ -3730,7 +3734,7 @@Делегат
+Delegate
Оффлайн режим. В данном режиме данные будут запрошены из кэша и возвращены -даже в случае истечения срока их действия (удаления не произойдет). -По умолчанию режим выключен.
+Offline mode, works for all requests. Current mode is used to return cache data even +if its lifetime ended, no deletion occurs (use this mode if no internet connection exists).
Defaults to NO.
+Начинать ли выполнение запросов немедленно или предоставить программисту -самому выбирать момент запуска запроса. -По умолчанию принимает значение YES.
+Allows developer to initiate immediate request start after its being created. +Defaults to YES.
Предположим, что вы хотите осуществить запрос пользовательской информации, но -начало хотите инициировать сами. Вот, как это может выглядеть:
+For instance, you want to request user’s information and initiate request when +user taps a button. Here is how it can be implemented:
VKRequestManager *rm = [[VKRequestManager alloc] init...];
rm.startAllRequestsImmediately = NO;
VKRequest *userInfo = [rm info];
+
-// пользователь нажал какую-то кнопку, после чего вы стартуете запрос
-[userInfo start];
+User taps a button and this method is called:
+ +[userInfo start];
-Если нет необходимоти выполнять отложенный запуск, то можно делать следующим образом:
+If there is not need to perform delayed requests than you should just call needed +method and don’t bother about something else. Looks like:
-// запрос стартует немедленно
+VKRequestManager *rm = [[VKRequestManager alloc] init...];
[rm info];
Пользователь от лица которого осуществляются запросы.
+User from whose face requests are made.
В случае, если ползовательский объект равен nil запрос будет осуществлен без -передачи токена доступа.
+If the user property equals nil than no access token is added.
Инициализация менеджера запросов
+Designated initialization method.
делегат
delegate, should conform to VKRequestDelegate
пользователь от лица которого будут осуществляться запросы
user from whose face requests are made
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-15)
+
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-20)
Generated by appledoc 2.1 (build 858).
Класс представляет собой хранилище для пользовательских токенов доступа и -закэшированных данных. -Основным хранимым элементом является элемент типа VKStorageItem, который содержит -пользовательский токен доступа и связанную с ним директорию для кэша.
+Class manages user access tokens and corresponding cached data.
isEmpty
- Является ли хранилище пустым
+Is current storage empty?
property count
- Кол-во элементов находящихся в хранилище
+Size of VKStorage storage (number of objects in it)
property fullStoragePath
- Полный путь к основной директории хранилища
+Full path to main storage directory
property fullCacheStoragePath
- Полный путь к основной директории кэша хранилища
+Full path to main cache directory
property @@ -231,14 +228,14 @@+ sharedStorage
- Общее хранилище
+Shared storage
@@ -246,14 +243,14 @@– createStorageItemForAccessToken:
- Создаёт элемент хранилища
+Creates new VKStorageItem
@@ -261,35 +258,35 @@– storeItem:
- Добавляет в хранилище новый элемент
+Adds new element to VKStorage
– removeItem:
- Удаляет из хранилища указанный элемент
+Removes VKStorageItem from VKStorage.
– clean
- Удаляет все данные из хранилища.
+Clears storage.
– cleanCachedData
- Удаляет все данные кэша в хранилище
+Removes all cached data for all users.
@@ -297,21 +294,21 @@– storageItemForUserID:
- Получение элемента хранилища по пользовательскому идентификатору
+Returns user’s corresponding VKStorageItem by unique user identifier
– storageItems
- Список всех элементов хранилища
+List of all items in current storage
@@ -335,7 +332,7 @@Кол-во элементов находящихся в хранилище
+Size of VKStorage storage (number of objects in it)
Полный путь к основной директории кэша хранилища
+Full path to main cache directory
Полный путь к основной директории хранилища
+Full path to main storage directory
Является ли хранилище пустым
+Is current storage empty?
Общее хранилище
+Shared storage
экземпляр класс VKStorage
+shared instance of VKStorage class
Удаляет все данные из хранилища.
+Clears storage.
Удаляет все данные кэша в хранилище
+Removes all cached data for all users.
Создаёт элемент хранилища
+Creates new VKStorageItem
пользовательский токен доступа для которого будет создан элемент хранилища
VKAccessToken for which new storage item will be created
Удаляет из хранилища указанный элемент
+Removes VKStorageItem from VKStorage.
элемент хранилища
item to remove from VKStorage
Получение элемента хранилища по пользовательскому идентификатору
+Returns user’s corresponding VKStorageItem by unique user identifier
пользовательский идентификатор
unique user identifier
экземпляр класса VKStorageItem, либо nil, если элемента в хранилище
+instance of VKStorageItem, or nil, if there is no such.
Список всех элементов хранилища
+List of all items in current storage
Добавляет в хранилище новый элемент
+Adds new element to VKStorage
элемент хранилища
new item to be added
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-15)
+
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-20)
Generated by appledoc 2.1 (build 858).
Класс представляет собой элемент хранилища VKStorage.
+Current class is used as an item of main VKStorage storage, which +persists data such as access tokens and cache.
accessToken
- Токен доступа
+Access token
property cache
- Кэш запросов
+Cache
property @@ -165,14 +166,14 @@– initWithAccessToken:mainCacheStoragePath:
- Инициализация элемента хранилища токеном доступа и директорией кэша
+Initialization method
@@ -196,7 +197,7 @@Токен доступа
+Access token
Кэш запросов
+Cache
Инициализация элемента хранилища токеном доступа и директорией кэша
+Initialization method
токен доступа с которым будет ассоциироваться элемент хранилища
access token which will be used as key in VKStorage storage
путь к директории в которой необходимо хранить кэш запросов
directory which will be used for cached data
экземпляр класс VKStorageItem
+instance of VKStorageItem class
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-15)
+
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-20)
Generated by appledoc 2.1 (build 858).
Класс представляет пользователя социальной сети, который может осуществлять ряд -действий с объектами вроде групп, друзей, музыкой, видео и тд.
- -Класс так же позволяет изменить текущего активного пользователя на одного из -пользователей находящихся в хранилище (ранее авторизованных). Получить список -пользователей, которые авторизовывались можно используя метод localUsers.
Warning: методы, которые требуют наличия access_token в запросе перезаписывают -токен доступа, если таковой был указан при передаче словаря ключей-значений, на -значение токена доступа текущего пользователя - self.accessToken.token.
Warning: по умолчанию у каждого запроса из класса VKUser подпись (signature) -является строкой селектора инициировавшего/создавшего объекта запроса
Manages users
accessToken
- Пользовательски токен доступа текущего активного пользователя
+User’s access token
property @@ -181,28 +173,28 @@+ currentUser
- Текущий активный пользователь.
+Current activated user
+ activateUserWithID:
- Делает активным пользователя с идентификатором userID.
+Activates user with passed unique user identifier
+ localUsers
- Получение списка пользователей находящихся в хранилище
+List of users which were saved in VKStorage
@@ -210,14 +202,14 @@– description
- Описание текущего пользователя
+Description of current user
@@ -241,7 +233,7 @@Пользовательски токен доступа текущего активного пользователя
+User’s access token
Делает активным пользователя с идентификатором userID.
+Activates user with passed unique user identifier
идентификатор пользователя, которого необходимо активировать
unique user identifier, user which should be activated
булево значение, удалось ли активировать указанного пользователя или нет
+YES - if user was activated, NO - otherwise
Если пользователя с таким идентификатором нет в хранилище, то метод вернет NO, иначе -YES.
+If there is no such user then NO will be returned, otherwise - YES.
Текущий активный пользователь.
+Current activated user
Если хранилище не содержит авторизованных пользователей, то возвращено будет значение -nil.
+If there is no users in VKStorage then nil will be returned. +If no user was activated, then random user will be activated.
-В случае, если активным не был установлен какой-то определенный пользователь, то -при вызове данного метода активируется произвольный пользователь из хранилища (если -в хранилище будет находится лишь один пользователь, то именно он будет активирован -и от его лица будут осуществляться дальнейшие запросы).
+Lets assume we have such situation:
-Вопрос: Когда может произойти подобная ситуация?
- -Ответ: Представим, что два и более пользователей подряд авторизовались и, во время -авторизаций не было вызовов метода currentUser.
- -Рассмотрим на примере:
- -// авторизовался пользователь А
-// авторизовался пользователь Б
-// авторизовался пользователь В
-[VKUser currentUser] // будет активирован произвольный пользователь, либо А, либо Б, либо В
+// user A authorized
+// user B authorized
+// user C authorized
+[VKUser currentUser] // random user will be activated - A or B or C
-Второй пример:
+Second example:
-// авторизовался пользователь А
-[VKUser currentUser] // активным устанавливается пользователь А
-// авторизовался пользователь Б, но А по прежнему активный
-// авторизовался пользователь В, но А по прежнему активный
+// user A authorized
+[VKUser currentUser] // user A becomes active user
+// user B authorized, but A is still active
+// user C authorized, but A is still active
+// so on.
Получение списка пользователей находящихся в хранилище
+List of users which were saved in VKStorage
массив пользовательских идентификаторов
+list of users (@(NSUInteger) objects - user unique identifiers)
Описание текущего пользователя
+Description of current user
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-15)
+
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-20)
Generated by appledoc 2.1 (build 858).
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-15)
+
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-20)
Generated by appledoc 2.1 (build 858).
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-15)
+
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-20)
Generated by appledoc 2.1 (build 858).
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-15)
+
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-20)
Generated by appledoc 2.1 (build 858).
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-15)
+
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-20)
Generated by appledoc 2.1 (build 858).
Класс содержит информацию о пользовательском токене доступа.
- -Кроме самого токена доступа хранится следующая информация:
+Current class works with user access token and stores information about +it:
permissions
- Массив пользовательских разрешений к которым был получен доступ приложением
+Array of permissions which were granted to current application
property creationTime
- Время создания токена
+Access token creation time
property liveTime
- Время жизни токена доступа.
+Access token life time.
property userID
- Пользовательский идентификатор в социальной сети ВКонтакте.
+Unique user identifier
property token
- Токен доступа.
+Token (access token)
property isExpired
- Истекло ли время действия текущего токена доступа или нет. -NO - если токен всё еще действует, иначе - YES.
+Is current access token expired?
property isValid
- Действителен ли токен.
+Is current access token valid?
property @@ -258,28 +256,28 @@– initWithUserID:accessToken:liveTime:permissions:
- Основной метод инициализации.
+Designated initialization method
– initWithUserID:accessToken:liveTime:
- Вторичный метод инициализации класса.
+Initialization method
– initWithUserID:accessToken:
- Вторичный метод инициализации класса.
+Initialization method
@@ -287,21 +285,21 @@– description
- Описание состояния класса VKAccessToken.
+Access token description.
– isEqual:
- Проверяет токены доступов на равенство
+Checks if two access tokens are equal.
@@ -309,14 +307,14 @@– hasPermission:
- Метод проверяет наличие определенного доступа в общем списке доступов данного токена.
+Method checks if list of permissions contains a permission.
@@ -340,7 +338,7 @@Время создания токена
+Access token creation time
Истекло ли время действия текущего токена доступа или нет. -NO - если токен всё еще действует, иначе - YES.
+Is current access token expired?
NO в следующих случаях:
+Current token is not expired if:
Действителен ли токен.
+Is current access token valid?
Возвращает YES, если токен неравен nil и срок его действия не истек.
+Returns YES if current access token is not nil and its not expired.
Время жизни токена доступа.
+Access token life time.
Массив пользовательских разрешений к которым был получен доступ приложением
+Array of permissions which were granted to current application
Токен доступа.
+Token (access token)
Пользовательский идентификатор в социальной сети ВКонтакте.
+Unique user identifier
Описание состояния класса VKAccessToken.
+Access token description.
Строковое представление текущего класса.
+String representation.
Метод проверяет наличие определенного доступа в общем списке доступов данного токена.
+Method checks if list of permissions contains a permission.
Наименование доступа.
permissions name (wall, offline, friends etc)
YES - если такое право присутствует в общем списке, иначе - NO.
+YES - if list of permissions contains current permission, otherwise NO +is returned.
Вторичный метод инициализации класса.
+Initialization method
Пользовательский идентификатор в социальной сети ВКонтакте
unique user identifier
Токен доступа.
access token
Объект VKAccessToken класса.
+instance of VKAccessToken class
permissions принимает значение по умолчанию @[].
- -liveTime принимает значение по умолчанию 0.
+List of permissions defaults to an empty list (@[]). +liveTime defaults to 0 (zero).
Вторичный метод инициализации класса.
+Initialization method
Пользовательский идентификатор в социальной сети ВКонтакте.
unique user identifier
Токен доступа.
access token
Время жизни токена доступа.
access token life time
Объект VKAccessToken класса.
+instance of VKAccessToken class
permissions принимает значение по умолчанию @[].
+List of permissions defaults to an empty list (@[]).
Основной метод инициализации.
+Designated initialization method
Пользовательский идентификатор в социальной сети ВКонтакте.
unique user identifier
Токен доступа.
access token
Время жизни токена доступа.
access token life time
Список полученных приложением прав.
list of all granted permissions
Объект VKAccessToken класса.
+instance of VKAccessToken class
Проверяет токены доступов на равенство
+Checks if two access tokens are equal.
токен доступа с которым необходимо сравнить
another access token
YES - если токены доступа равны (на результат сравнения влияет только сам -токен доступа, список пользовательских разрешений и идентификатор пользователя, которому -принадлежит данный токен)
+YES - if two access tokens are equal (tokens are equal if and only if their +corresponding tokens, list of permissions and userIDs are equal), otherwise NO +is returned.
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-15)
+
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-20)
Generated by appledoc 2.1 (build 858).
Класс предназначен для хранения, получения, удаления кэша запросов. -Хранение кэша осуществляется на диске и в директории указанной при инициализации -класса.
+Current class manages cached responses' data. Cached data are saved in +directory which was selected during initialization process.
– initWithCacheDirectory:
- Инициализация объекта для кэширования запросов
+Initialization methods
@@ -175,43 +174,42 @@– addCache:forURL:
- Добавляет данные в кэш
+Current method adds new data to cached data directory
– addCache:forURL:liveTime:
- Добавляет данные в кэш
+Current method adds new data to cached data directory
– removeCacheForURL:
- Удаление кэша указанного URL
+Removes cached data by its URL
– clear
- Удаление всех закэшированных данных в директории, которой был инициализирован -данный объект
+Removes all cached data in a directory which were used for initialization.
– removeCacheDirectory
- Удаление директории с данными кэша
+Removes directory with all cached data.
@@ -219,23 +217,22 @@– cacheForURL:
- Возвращает закэшированные данные по указанному URL, либо nil, если время действия -кэша истекло или его нет.
+Returns cached data by its URL, or nil, if life time of cached data has expired.
– cacheForURL:offlineMode:
- Возвращает закэшированные данные по указанному URL, либо nil, если для данного -запроса нет кэша.
+Returns cached data by its URL, or nil, if life time of cached data has +expired or there is no data for current URL.
@@ -263,7 +260,7 @@Добавляет данные в кэш
+Current method adds new data to cached data directory
данные, которые необходимо закэшировать
data which should be cached
URL который соответствует кешируемым данным
URL that corresponds to cached data
По умолчанию время жизни кэша устанавливается равным одному часу.
+Life time of current cached data defaults to one hour.
Добавляет данные в кэш
+Current method adds new data to cached data directory
данные, которые необходимо закэшировать
data which should be cached
URL который соответствует кешируемым данным
URL that corresponds to cached data
время жизни кэша. Возможные варианты перечислены в VKCacheLiveTime -(VKCacheLiveTimeOneHour, VKCacheLiveTimeOneDay, VKCacheLiveTimeForever etc)
life time of current cached data (possible values: VKCacheLiveTimeOneHour, +VKCacheLiveTimeOneDay, VKCacheLiveTimeForever etc).
Возвращает закэшированные данные по указанному URL, либо nil, если время действия -кэша истекло или его нет.
+Returns cached data by its URL, or nil, if life time of cached data has expired.
URL, закэшированные данные по которому необходимо получить
URL that corresponds to cached data
экземпляр класса NSData, закэшированные данные указанного URL
+instance of NSData class, cached data
Возвращает закэшированные данные по указанному URL, либо nil, если для данного -запроса нет кэша.
+Returns cached data by its URL, or nil, if life time of cached data has +expired or there is no data for current URL.
URL, закэшированные данные по которому необходимо получить
URL that corresponds to cached data
оффлайн режим запроса кэша (как работает описано в Обсуждении)
offline mode
экземпляр класса NSData, закэшированные данные указанного URL
+instance of NSData class, cached data which corresponds to received URL
Параметр offlineMode влияет на возвращаемые данные следующим образом: если передается -YES и в кэше есть данные для этого URL, но срок их жизни истек, то они всё равно -будут возвращены (без удаления, до последующего обновления). -Если параметр offlineMode равен NO, то при запросе данных из кэша, они будут -удалены в случае, если время жизни данных истекло.
- -Использование данного метода с передачей значения YES в параметре offlineMode -полезно при отсутствии интернет соединения.
+As you know, offlineMode can make current method return cached data even if its +life time expired. You should use offlineMode (YES) if there is no internet +connection.
Удаление всех закэшированных данных в директории, которой был инициализирован -данный объект
+Removes all cached data in a directory which were used for initialization.
Инициализация объекта для кэширования запросов
+Initialization methods
директория в которой должны будут храниться кэшируемые данные. -Если директория не существует, то будет создана.
directory where would be saved cached data. If there is no such +directory then it’s going to be created.
объект типа VKCache
+instance of VKCache
Удаление директории с данными кэша
+Removes directory with all cached data.
Удаление кэша указанного URL
+Removes cached data by its URL
URL, закэшированные данные которого необходимо удалить
URL that corresponds to cached data which needs to be removed
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-15)
+
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-20)
Generated by appledoc 2.1 (build 858).
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-15)
+
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-20)
Generated by appledoc 2.1 (build 858).
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-15)
+
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-20)
Generated by appledoc 2.1 (build 858).
Класс предназначен для управления запросами к серверу ВК.
+Current class gives possibility to perform requests to VK servers.
-Процент покрываемых методов: 100%
+The most updated information and documentation on methods you can get +from official VK Developers page: https://vk.com/dev/main
+ +Methods which are documented in Russian (in current file) won’t be translated +in English, so please refer to VK official English documentation.
+ +Methods covered: 100%.
user
- Пользователь от лица которого осуществляются запросы.
+User from whose face requests are made.
property delegate
- Делегат
+Delegate
property startAllRequestsImmediately
- Начинать ли выполнение запросов немедленно или предоставить программисту -самому выбирать момент запуска запроса. -По умолчанию принимает значение YES.
+Allows developer to initiate immediate request start after its being created. +Defaults to YES.
property offlineMode
- Оффлайн режим. В данном режиме данные будут запрошены из кэша и возвращены -даже в случае истечения срока их действия (удаления не произойдет). -По умолчанию режим выключен.
+Offline mode, works for all requests. Current mode is used to return cache data even +if its lifetime ended, no deletion occurs (use this mode if no internet connection exists).
property @@ -1419,14 +1423,14 @@– initWithDelegate:user:
- Инициализация менеджера запросов
+Designated initialization method.
@@ -1434,84 +1438,106 @@– notesGet:
- Возвращает список заметок, созданных пользователем.
+– searchGetHints:
+ Метод позволяет получить результаты быстрого поиска по произвольной подстроке
+ + + +– placesAdd:
+ Добавляет новое место в базу географических мест.
– notesGetByID:
- Возвращает заметку по её id
+– placesGetByID:
+ Возвращает информацию о местах по их идентификаторам.
– notesGetFriendsNotes:
- Возвращает список заметок друзей пользователя.
+– placesSearch:
+ Возвращает список мест, найденных по заданным условиям поиска.
– notesAdd:
- Создает новую заметку у текущего пользователя
+– placesCheckIn:
+ Отмечает пользователя в указанном месте.
– notesEdit:
- Редактирует заметку текущего пользователя.
+– placesGetCheckins:
+ Возвращает список отметок пользователей в местах согласно заданным параметрам.
– notesDelete:
- Удаляет заметку текущего пользователя
+– placesGetTypes:
+ Возвращает список всех возможных типов мест.
– notesGetComments:
- Возвращает список комментариев к заметке
+– placesGetContries:
+ Возвращает список стран.
– notesCreateComment:
- Добавляет новый комментарий к заметке
+– placesGetRegions:
+ Возвращает список регионов.
– notesEditComment:
- Редактирует указанный комментарий у заметки
+– placesGetStreetByID:
+ Возвращает информацию об улицах по их идентификаторам (id).
– notesDeleteComment:
- Удаляет комментарий к заметке
+– placesGetCountryByID:
+ Возвращает информацию о странах по их идентификаторам
– notesRestoreComment:
- Восстанавливает удалённый комментарий
+– placesGetCities:
+ Возвращает список городов.
+ + + +– placesGetCityByID:
+ Возвращает информацию о городах по их идентификаторам.
@@ -1519,246 +1545,253 @@– adsGetAccounts:
- Возвращает список рекламных кабинетов.
+– audioGet:
+ Возвращает список аудиозаписей пользователя или сообщества
– adsGetClients:
- Возвращает список клиентов рекламного агентства.
+– audioGetByID:
+ Возвращает информацию об аудиозаписях
– adsCreateClients:
- Создает клиентов рекламного агентства.
+– audioGetLyrics:
+ Возвращает текст аудиозаписи
– adsUpdateClients:
- Редактирует клиентов рекламного агентства. -Доступно только для рекламных агентств.
+– audioSearch:
+ Возвращает список аудиозаписей в соответствии с заданным критерием поиска
– adsDeleteClients:
- Архивирует клиентов рекламного агентства.
+– audioGetUploadServer:
+ Возвращает адрес сервера для загрузки аудиозаписей
– adsGetCampaigns:
- Возвращает список кампаний рекламного кабинета.
+– audioSave:
+ Сохраняет аудиозаписи после успешной загрузки
– adsCreateCampaigns:
- Создает рекламные кампании. -Внимание! Допустимое количество кампаний, создаваемых с помощью одного запроса — 50.
+– audioAdd:
+ Копирует аудиозапись на страницу пользователя или группы
– adsUpdateCampaings:
- Редактирует рекламные кампании.
+– audioDelete:
+ Удаляет аудиозапись со страницы пользователя или сообщества
– adsDeleteCampaings:
- Архивирует рекламные кампании.
+– audioEdit:
+ Редактирует данные аудиозаписи на странице пользователя или сообщества
– adsGet:
- Возвращает список рекламных объявлений.
+– audioReorder:
+ Изменяет порядок аудиозаписи, перенося ее между аудиозаписями, идентификаторы которых переданы параметрами after и before
– adsGetLayout:
- Возвращает описания внешнего вида рекламных объявлений.
+– audioRestore:
+ Восстанавливает аудиозапись после удаления
– adsGetTargeting:
- Возвращает параметры таргетинга рекламных объявлений
+– audioGetAlbums:
+ Возвращает список альбомов аудиозаписей пользователя или группы
– adsCreate:
- Создает рекламные объявления.
+– audioAddAlbum:
+ Создает пустой альбом аудиозаписей
– adsUpdate:
- Редактирует рекламные объявления.
+– audioEditAlbum:
+ Редактирует название альбома аудиозаписей
– adsDelete:
- Архивирует рекламные объявления.
+– audioDeleteAlbum:
+ Удаляет альбом аудиозаписей
– adsGetStatistics:
- Возвращает статистику показателей эффективности по рекламным объявлениям, -кампаниям, клиентам или всему кабинету.
+– audioMoveToAlbum:
+ Перемещает аудиозаписи в альбом
– adsGetDemographics:
- Возвращает демографическую статистику по рекламным объявлениям или кампаниям.
+– audioSetBroadcast:
+ Транслирует аудиозапись в статус пользователю или сообществу
– adsGetBudget:
- Возвращает текущий бюджет рекламного кабинета.
+– audioGetBroadcastList:
+ Возвращает список друзей и сообществ пользователя, которые транслируют музыку в статус
– adsGetOfficeUsers:
- Возвращает список администраторов и наблюдателей рекламного кабинета.
+– audioGetRecommendations:
+ Возвращает список рекомендуемых аудиозаписей на основе списка воспроизведения заданного пользователя или на основе одной выбранной аудиозаписи
– adsAddOfficeUsers:
- Добавляет администраторов и/или наблюдателей в рекламный кабинет.
+– audioGetPopular:
+ Возвращает список аудиозаписей из раздела “Популярное”
– adsRemoveOfficeUsers:
- Удаляет администраторов и/или наблюдателей из рекламного кабинета.
+– audioGetCount:
+ Возвращает количество аудиозаписей пользователя или сообщества
-– adsGetTargetingStats:
- Возвращает размер целевой аудитории таргетинга, а также рекомендованные -значения CPC и CPM.
+– boardGetTopics:
+ Возвращает список тем в обсуждениях указанной группы.
– adsGetSuggestions:
- Возвращает набор подсказок автодополнения для различных параметров таргетинга.
+– boardGetComments:
+ Возвращает список сообщений в указанной теме.
– adsGetCategories:
- Получение тематик объявлений.
+– boardAddTopic:
+ Создает новую тему в списке обсуждений группы.
– adsGetUploadURL:
- Возвращает URL-адрес для загрузки фотографии рекламного объявления.
+– boardAddComment:
+ Добавляет новое сообщение в теме сообщества.
– adsGetVideoUploadURL:
- Возвращает URL-адрес для загрузки видеозаписи рекламного объявления.
+– boardDeleteTopic:
+ Удаляет тему в обсуждениях группы
– adsGetFloodStats:
- Возвращает информацию о текущем состоянии счетчика — количество оставшихся -запусков методов и время до следующего обнуления счетчика в секундах.
+– boardEditTopic:
+ Изменяет заголовок темы в списке обсуждений группы
– adsGetRejectionReason:
- Возвращает причину, по которой указанному объявлению было отказано в -прохождении премодерации.
+– boardEditComment:
+ Редактирует одно из сообщений в теме группы
– adsCreateTargetGroup:
- Создает группу для ретаргетинга рекламных объявлений на пользователей, -которые посетили сайт рекламодателя (просмотрели информации о товаре, зарегистрировались и т.д.).
- +– boardRestoreComment:
+ Восстанавливает удаленное сообщение темы в обсуждениях группы
+– adsUpdateTargetGroup:
- Редактирует группу ретаргетинга.
+– boardDeleteComment:
+ Удаляет сообщение темы в обсуждениях сообщества
– adsDeleteTargetGroup:
- Удаляет группу ретаргетинга.
+– boardOpenTopic:
+ Открывает ранее закрытую тему (в ней станет возможно оставлять новые сообщения).
– adsGetTargetGroups:
- Возвращает список групп таргетирования.
+– boardCloseTopic:
+ Закрывает тему в списке обсуждений группы (в такой теме невозможно оставлять новые сообщения)
– adsImportTargetContacts:
- Импортирует список контактов рекламодателя для учета зарегистрированных во -ВКонтакте пользователей в срезе группы таргетирования.
+– boardFixTopic:
+ Закрепляет тему в списке обсуждений группы (такая тема при любой сортировке выводится выше остальных)
+ + + +– boardUnfixTopic:
+ Отменяет прикрепление темы в списке обсуждений группы (тема будет выводиться согласно выбранной сортировке)
@@ -1766,134 +1799,134 @@– pollsGetByID:
- Возвращает детальную информацию об опросе по его идентификатору.
+– pagesGet:
+ Возвращает информацию о вики-странице.
– pollsAddVote:
- Отдает голос текущего пользователя за выбранный вариант ответа в указанном опросе.
+– pagesSave:
+ Сохраняет текст вики-страницы.
– pollsDeleteVote:
- Снимает голос текущего пользователя с выбранного варианта ответа в указанном опросе.
+– pagesSaveAccess:
+ Сохраняет новые настройки доступа на чтение и редактирование вики-страницы.
– pollsGetVoters:
- Получает список идентификаторов пользователей, которые выбрали определенные варианты ответа в опросе.
+– pagesGetHistory:
+ Возвращает список всех старых версий вики-страницы.
-– accountGetCounters:
- Возвращает ненулевые значения счетчиков пользователя
+– pagesGetTitles:
+ Возвращает список вики-страниц в группе.
– accountSetNameInMenu:
- Устанавливает короткое название приложения (до 17 символов), которое выводится пользователю в левом меню.
+– pagesGetVersion:
+ Возвращает текст одной из старых версий страницы.
– accountSetOnline:
- Помечает текущего пользователя как online на 15 минут.
+– pagesParseWiki:
+ Возвращает html-представление вики-разметки
-– accountImportContacts:
- Принимает список контактов пользователя для поиска зарегистрированных во ВКонтакте пользователей методом friends.getSuggestions.
+– newsfeedGet:
+ Возвращает данные, необходимые для показа списка новостей для текущего пользователя
– accountRegisterDevice:
- Подписывает устройство на базе iOS, Android иди Windows Phone на получение Push-уведомлений.
+– newsfeedGetRecommended:
+ Получает список новостей, рекомендованных пользователю
– accountUnregisterDevice:
- Отписывает устройство от Push уведомлений.
+– newsfeedGetComments:
+ Возвращает данные, необходимые для показа раздела комментариев в новостях пользователя
– accountSetSilenceMode:
- Отключает push-уведомления на заданный промежуток времени.
+– newsfeedGetMentions:
+ Возвращает список записей пользователей на своих стенах, в которых упоминается указанный пользователь
– accountGetPushSettings:
- Позволяет получать настройки Push уведомлений.
+– newsfeedGetBanned:
+ Возвращает список пользователей и групп, которые текущий пользователь скрыл из ленты новостей
– accountGetAppPermissions:
- Получает настройки текущего пользователя в данном приложении.
+– newsfeedAddBan:
+ Запрещает показывать новости от заданных пользователей и групп в ленте новостей текущего пользователя
– accountGetActiveOffers:
- Возвращает список активных рекламных предложений (офферов), выполнив которые пользователь сможет получить соответствующее количество голосов на свой счёт внутри приложения.
+– newsfeedDeleteBan:
+ Разрешает показывать новости от заданных пользователей и групп в ленте новостей текущего пользователя
– accountBanUser:
- Добавляет пользователя в черный список.
+– newsfeedSearch:
+ Возвращает результаты поиска по статусам
– accountUnbanUser:
- Убирает пользователя из черного списка.
+– newsfeedGetLists:
+ Возвращает пользовательские списки новостей
– accountGetBanned:
- Возвращает список пользователей, находящихся в черном списке.
+– newsfeedUnsubscribe:
+ Отписывает текущего пользователя от комментариев к заданному объекту
@@ -1901,56 +1934,35 @@– pagesGet:
- Возвращает информацию о вики-странице.
- - - -– pagesSave:
- Сохраняет текст вики-страницы.
- - - -– pagesSaveAccess:
- Сохраняет новые настройки доступа на чтение и редактирование вики-страницы.
- - - -– pagesGetHistory:
- Возвращает список всех старых версий вики-страницы.
+– likesGetList:
+ Получает список идентификаторов пользователей, которые добавили заданный объект в свой список Мне нравится.
– pagesGetTitles:
- Возвращает список вики-страниц в группе.
+– likesAdd:
+ Добавляет указанный объект в список Мне нравится текущего пользователя
– pagesGetVersion:
- Возвращает текст одной из старых версий страницы.
+– likesDelete:
+ Удаляет указанный объект из списка Мне нравится текущего пользователя
– pagesParseWiki:
- Возвращает html-представление вики-разметки
+– likesIsLiked:
+ Проверяет, находится ли объект в списке Мне нравится заданного пользователя.
@@ -1958,277 +1970,246 @@– appsGetCatalog:
- Возвращает список приложений, доступных для пользователей сайта через каталог приложений.
+– adsGetAccounts:
+ Возвращает список рекламных кабинетов.
-– databaseGetCountries:
- Возвращает список стран.
+– adsGetClients:
+ Возвращает список клиентов рекламного агентства.
– databaseGetRegions:
- Возвращает список регионов.
+– adsCreateClients:
+ Создает клиентов рекламного агентства.
– databaseGetStreetsById:
- Возвращает информацию об улицах по их идентификаторам (id).
+– adsUpdateClients:
+ Редактирует клиентов рекламного агентства. +Доступно только для рекламных агентств.
– databaseGetCountriesById:
- Возвращает информацию о странах по их идентификаторам
+– adsDeleteClients:
+ Архивирует клиентов рекламного агентства.
– databaseGetCities:
- Возвращает список городов.
+– adsGetCampaigns:
+ Возвращает список кампаний рекламного кабинета.
– databaseGetCitiesById:
- Возвращает информацию о городах по их идентификаторам.
+– adsCreateCampaigns:
+ Создает рекламные кампании. +Внимание! Допустимое количество кампаний, создаваемых с помощью одного запроса — 50.
– databaseGetUniversities:
- Возвращает список высших учебных заведений.
+– adsUpdateCampaings:
+ Редактирует рекламные кампании.
– databaseGetSchools:
- Возвращает список школ.
+– adsDeleteCampaings:
+ Архивирует рекламные кампании.
– databaseGetFaculties:
- Возвращает список факультетов.
+– adsGet:
+ Возвращает список рекламных объявлений.
-– placesAdd:
- Добавляет новое место в базу географических мест.
+– adsGetLayout:
+ Возвращает описания внешнего вида рекламных объявлений.
– placesGetByID:
- Возвращает информацию о местах по их идентификаторам.
+– adsGetTargeting:
+ Возвращает параметры таргетинга рекламных объявлений
– placesSearch:
- Возвращает список мест, найденных по заданным условиям поиска.
+– adsCreate:
+ Создает рекламные объявления.
– placesCheckIn:
- Отмечает пользователя в указанном месте.
+– adsUpdate:
+ Редактирует рекламные объявления.
– placesGetCheckins:
- Возвращает список отметок пользователей в местах согласно заданным параметрам.
+– adsDelete:
+ Архивирует рекламные объявления.
– placesGetTypes:
- Возвращает список всех возможных типов мест.
+– adsGetStatistics:
+ Возвращает статистику показателей эффективности по рекламным объявлениям, +кампаниям, клиентам или всему кабинету.
– placesGetContries:
- Возвращает список стран.
+– adsGetDemographics:
+ Возвращает демографическую статистику по рекламным объявлениям или кампаниям.
– placesGetRegions:
- Возвращает список регионов.
+– adsGetBudget:
+ Возвращает текущий бюджет рекламного кабинета.
– placesGetStreetByID:
- Возвращает информацию об улицах по их идентификаторам (id).
+– adsGetOfficeUsers:
+ Возвращает список администраторов и наблюдателей рекламного кабинета.
– placesGetCountryByID:
- Возвращает информацию о странах по их идентификаторам
+– adsAddOfficeUsers:
+ Добавляет администраторов и/или наблюдателей в рекламный кабинет.
– placesGetCities:
- Возвращает список городов.
+– adsRemoveOfficeUsers:
+ Удаляет администраторов и/или наблюдателей из рекламного кабинета.
– placesGetCityByID:
- Возвращает информацию о городах по их идентификаторам.
- - - -– newsfeedGet:
- Возвращает данные, необходимые для показа списка новостей для текущего пользователя
+– adsGetTargetingStats:
+ Возвращает размер целевой аудитории таргетинга, а также рекомендованные +значения CPC и CPM.
– newsfeedGetRecommended:
- Получает список новостей, рекомендованных пользователю
+– adsGetSuggestions:
+ Возвращает набор подсказок автодополнения для различных параметров таргетинга.
– newsfeedGetComments:
- Возвращает данные, необходимые для показа раздела комментариев в новостях пользователя
+– adsGetCategories:
+ Получение тематик объявлений.
– newsfeedGetMentions:
- Возвращает список записей пользователей на своих стенах, в которых упоминается указанный пользователь
+– adsGetUploadURL:
+ Возвращает URL-адрес для загрузки фотографии рекламного объявления.
– newsfeedGetBanned:
- Возвращает список пользователей и групп, которые текущий пользователь скрыл из ленты новостей
+– adsGetVideoUploadURL:
+ Возвращает URL-адрес для загрузки видеозаписи рекламного объявления.
– newsfeedAddBan:
- Запрещает показывать новости от заданных пользователей и групп в ленте новостей текущего пользователя
+– adsGetFloodStats:
+ Возвращает информацию о текущем состоянии счетчика — количество оставшихся +запусков методов и время до следующего обнуления счетчика в секундах.
– newsfeedDeleteBan:
- Разрешает показывать новости от заданных пользователей и групп в ленте новостей текущего пользователя
+– adsGetRejectionReason:
+ Возвращает причину, по которой указанному объявлению было отказано в +прохождении премодерации.
– newsfeedSearch:
- Возвращает результаты поиска по статусам
+– adsCreateTargetGroup:
+ Создает группу для ретаргетинга рекламных объявлений на пользователей, +которые посетили сайт рекламодателя (просмотрели информации о товаре, зарегистрировались и т.д.).
– newsfeedGetLists:
- Возвращает пользовательские списки новостей
+– adsUpdateTargetGroup:
+ Редактирует группу ретаргетинга.
– newsfeedUnsubscribe:
- Отписывает текущего пользователя от комментариев к заданному объекту
+– adsDeleteTargetGroup:
+ Удаляет группу ретаргетинга.
-– statusGet:
- Получает текст статуса пользователя или сообщества.
+– adsGetTargetGroups:
+ Возвращает список групп таргетирования.
– statusSet:
- Устанавливает новый статус текущему пользователю.
+– adsImportTargetContacts:
+ Импортирует список контактов рекламодателя для учета зарегистрированных во +ВКонтакте пользователей в срезе группы таргетирования.
@@ -2236,56 +2217,23 @@– docsGet:
- Возвращает расширенную информацию о документах пользователя или сообщества.
- - - -– docsGetByID:
- Возвращает информацию о документах по их идентификаторам.
- - - -– docsGetUploadServer:
- Возвращает адрес сервера для загрузки документов.
- - - -– docsGetWallUploadServer:
- Возвращает адрес сервера для загрузки документов в папку Отправленные, для последующей отправки документа на стену или личным сообщением.
- - - -– docsSave:
- Сохраняет документ после его успешной загрузки на сервер.
- - - -– docsDelete:
- Удаляет документ пользователя или группы
+– execute:
+ Универсальный метод, который позволяет запускать последовательность других +методов, сохраняя и фильтруя промежуточные результаты.
– docsAdd:
- Копирует документ в документы текущего пользователя
+– executePredefinedProcedureWithName:options:
+ Хранимые процедуры позволяют исполнять код на стороне сервера API аналогично +методу execute, но без передачи кода процедуры по сети.
@@ -2293,49 +2241,14 @@– info
- Информация о текущем пользователе.
- - - -– info:
- Информация о пользователе(ях) с указанными параметрами
- - - -– search:
- Возвращает список пользователей в соответствии с заданным критерием поиска
- - - -– subscriptions:
- Возвращает список идентификаторов пользователей и групп, которые входят в список подписок пользователя
- - - -– followers:
- Возвращает список идентификаторов пользователей, которые являются подписчиками пользователя. Идентификаторы пользователей в списке отсортированы в порядке убывания времени их добавления.
- - - -– isAppUser:
- Возвращает информацию о том, установил ли пользователь приложение.
+– appsGetCatalog:
+ Возвращает список приложений, доступных для пользователей сайта через каталог приложений.
@@ -2428,266 +2341,336 @@– photosCreateAlbum:
- Создает пустой альбом для фотографий
+– info
+ Информация о текущем пользователе.
– photosEditAlbum:
- Редактирует данные альбома для фотографий пользователя
+– info:
+ Информация о пользователе(ях) с указанными параметрами
– photosGetAlbums:
- Возвращает список альбомов пользователя или сообщества
+– search:
+ Возвращает список пользователей в соответствии с заданным критерием поиска
– photosGet:
- Возвращает список фотографий в альбоме
+– subscriptions:
+ Возвращает список идентификаторов пользователей и групп, которые входят в список подписок пользователя
– photosGetAlbumsCount:
- Возвращает количество доступных альбомов пользователя
+– followers:
+ Возвращает список идентификаторов пользователей, которые являются подписчиками пользователя. Идентификаторы пользователей в списке отсортированы в порядке убывания времени их добавления.
– photosGetProfile:
- Возвращает список фотографий со страницы пользователя или сообщества
+– isAppUser:
+ Возвращает информацию о том, установил ли пользователь приложение.
-– photosGetByID:
- Возвращает информацию о фотографиях по их идентификаторам
+– notificationsGet:
+ Возвращает список оповещений об ответах других пользователей на записи текущего пользователя.
– photosGetUploadServer:
- Возвращает адрес сервера для загрузки фотографий
+– notificationsMarkeAsViewed:
+ Сбрасывает счетчик непросмотренных оповещений об ответах других пользователей на записи текущего пользователя.
-– photosGetProfileUploadServer:
- Возвращает адрес сервера для загрузки фотографии на страницу пользователя
+– pollsGetByID:
+ Возвращает детальную информацию об опросе по его идентификатору.
– photosGetChatUploadServer:
- Позволяет получить адрес для загрузки фотографий мультидиалогов
+– pollsAddVote:
+ Отдает голос текущего пользователя за выбранный вариант ответа в указанном опросе.
– photosSaveProfilePhoto:
- Сохраняет фотографию пользователя после успешной загрузки
+– pollsDeleteVote:
+ Снимает голос текущего пользователя с выбранного варианта ответа в указанном опросе.
– photosSaveWallPhoto:
- Сохраняет фотографии после успешной загрузки на URI, полученный методом photos.getWallUploadServer
- +– pollsGetVoters:
+ Получает список идентификаторов пользователей, которые выбрали определенные варианты ответа в опросе.
+ -– photosGetWallUploadServer:
- Возвращает адрес сервера для загрузки фотографии на стену пользователя.
+– statsGet:
+ Возвращает статистику сообщества или приложения.
+ + + +– utilsCheckLink:
+ Возвращает информацию о том, является ли ссылка заблокированной на сайте ВКонтакте.
– photosGetMessagesUploadServer:
- Возвращает адрес сервера для загрузки фотографии в личное сообщение пользователю
+– utilsResolveScreenName:
+ Определяет тип объекта (пользователь, сообщество, приложение) и его +идентификатор по короткому имени screen_name.
– photosSaveMessagesPhoto:
- Сохраняет фотографию после успешной загрузки на URI, полученный методом photos.getMessagesUploadServer
+– utilsGetServerTime:
+ Возвращает текущее время на сервере ВКонтакте в unixtime.
+ + + +– friendsGet:
+ Возвращает список идентификаторов друзей пользователя или расширенную информацию о друзьях пользователя (при использовании параметра fields)
– photosSearch:
- Осуществляет поиск изображений по местоположению или описанию
+– friendsGetOnline:
+ Возвращает список идентификаторов друзей пользователя, находящихся на сайте
– photosSave:
- Сохраняет фотографии после успешной загрузки
+– friendsGetMutual:
+ Возвращает список идентификаторов общих друзей между парой пользователей
– photosEdit:
- Изменяет описание у выбранной фотографии
+– friendsGetRecent:
+ Возвращает список идентификаторов недавно добавленных друзей текущего пользователя
– photosMove:
- Переносит фотографию из одного альбома в другой
+– friendsGetRequests:
+ Возвращает информацию о полученных или отправленных заявках на добавление в друзья для текущего пользователя
– photosMakeCover:
- Делает фотографию обложкой альбома
+– friendsAdd:
+ Одобряет или создает заявку на добавление в друзья.
– photosReorderAlbums:
- Меняет порядок альбома в списке альбомов пользователя
+– friendsEdit:
+ Редактирует списки друзей для выбранного друга
– photosReorderPhotos:
- Меняет порядок фотографии в списке фотографий альбома пользователя
+– friendsDelete:
+ Удаляет пользователя из списка друзей или отклоняет заявку в друзья
– photosGetAll:
- Возвращает все фотографии пользователя или сообщества в антихронологическом порядке
+– friendsGetLists:
+ Возвращает список меток друзей текущего пользователя
– photosGetUserPhotos:
- Возвращает список фотографий, на которых отмечен пользователь
+– friendsAddList:
+ Создает новый список друзей у текущего пользователя
– photosDeleteAlbum:
- Удаляет указанный альбом для фотографий у текущего пользователя
+– friendsEditList:
+ Редактирует существующий список друзей текущего пользователя
– photosDelete:
- Удаление фотографии на сайте
+– friendsDeleteList:
+ Удаляет существующий список друзей текущего пользователя
– photosConfirmTagWithCustomOptions:
- Подтверждает отметку на фотографии
+– friendsGetAppUsers:
+ Возвращает список идентификаторов друзей текущего пользователя, которые установили данное приложение
– photosGetComments:
- Возвращает список комментариев к фотографии
+– friendsGetByPhones:
+ Возвращает список друзей пользователя, у которых завалидированные или указанные в профиле телефонные номера входят в заданный список.
– photosGetAllComments:
- Возвращает отсортированный в антихронологическом порядке список всех комментариев к конкретному альбому или ко всем альбомам пользователя
+– friendsDeleteAllRequests:
+ Отмечает все входящие заявки на добавление в друзья как просмотренные
– photosCreateComment:
- Создает новый комментарий к фотографии
+– friendsGetSuggestions:
+ Возвращает список профилей пользователей, которые могут быть друзьями текущего пользователя.
– photosDeleteComment:
- Удаляет комментарий к фотографии
+– friendsAreFriends:
+ Возвращает информацию о том, добавлен ли текущий пользователь в друзья у указанных пользователей.
+ + + +– docsGet:
+ Возвращает расширенную информацию о документах пользователя или сообщества.
– photosRestoreComment:
- Восстанавливает удаленный комментарий к фотографии
+– docsGetByID:
+ Возвращает информацию о документах по их идентификаторам.
– photosEditComment:
- Изменяет текст комментария к фотографии
+– docsGetUploadServer:
+ Возвращает адрес сервера для загрузки документов.
– photosGetTags:
- Возвращает список отметок на фотографии
+– docsGetWallUploadServer:
+ Возвращает адрес сервера для загрузки документов в папку Отправленные, для последующей отправки документа на стену или личным сообщением.
– photosPutTag:
- Добавляет отметку на фотографию
+– docsSave:
+ Сохраняет документ после его успешной загрузки на сервер.
– photosRemoveTag:
- Удаляет отметку с фотографии
+– docsDelete:
+ Удаляет документ пользователя или группы
– photosGetNewTags:
- Возвращает список фотографий, на которых есть непросмотренные отметки
+– docsAdd:
+ Копирует документ в документы текущего пользователя
@@ -2695,145 +2678,155 @@– statsGet:
- Возвращает статистику сообщества или приложения.
+– databaseGetCountries:
+ Возвращает список стран.
-– wallGet:
- Возвращает список записей со стены пользователя или сообщества
+– databaseGetRegions:
+ Возвращает список регионов.
– wallGetByID:
- Возвращает список записей со стен пользователей по их идентификаторам
+– databaseGetStreetsById:
+ Возвращает информацию об улицах по их идентификаторам (id).
– wallSavePost:
- Сохраняет запись на стене пользователя. Запись может содержать фотографию, ранее загруженную на сервер ВКонтакте, или любую доступную фотографию из альбома пользователя. -При запуске со стены приложение открывается в окне размером 607x412 и ему передаются параметры, описанные здесь.
+– databaseGetCountriesById:
+ Возвращает информацию о странах по их идентификаторам
– wallPost:
- Публикует новую запись на своей или чужой стене. -Данный метод позволяет создать новую запись на стене, а также опубликовать предложенную новость или отложенную запись.
+– databaseGetCities:
+ Возвращает список городов.
– wallRepost:
- Копирует объект на стену пользователя или сообщества
+– databaseGetCitiesById:
+ Возвращает информацию о городах по их идентификаторам.
– wallGetReposts:
- Позволяет получать список репостов заданной записи
+– databaseGetUniversities:
+ Возвращает список высших учебных заведений.
– wallEdit:
- Редактирует запись на стене
+– databaseGetSchools:
+ Возвращает список школ.
– wallDelete:
- Удаляет запись со стены
+– databaseGetFaculties:
+ Возвращает список факультетов.
+ + + +– notesGet:
+ Возвращает список заметок, созданных пользователем.
– wallRestore:
- Восстанавливает удаленную запись на стене пользователя
+– notesGetByID:
+ Возвращает заметку по её id
– wallGetComments:
- Возвращает список комментариев к записи на стене пользователя
+– notesGetFriendsNotes:
+ Возвращает список заметок друзей пользователя.
– wallAddComment:
- Добавляет комментарий к записи на стене пользователя или сообщества
+– notesAdd:
+ Создает новую заметку у текущего пользователя
– wallDeleteComment:
- Удаляет комментарий текущего пользователя к записи на своей или чужой стене
+– notesEdit:
+ Редактирует заметку текущего пользователя.
– wallRestoreComment:
- Восстанавливает комментарий текущего пользователя к записи на своей или чужой стене
+– notesDelete:
+ Удаляет заметку текущего пользователя
+ + + +– notesGetComments:
+ Возвращает список комментариев к заметке
+ + + +– notesCreateComment:
+ Добавляет новый комментарий к заметке
-– utilsCheckLink:
- Возвращает информацию о том, является ли ссылка заблокированной на сайте ВКонтакте.
+– notesEditComment:
+ Редактирует указанный комментарий у заметки
– utilsResolveScreenName:
- Определяет тип объекта (пользователь, сообщество, приложение) и его -идентификатор по короткому имени screen_name.
+– notesDeleteComment:
+ Удаляет комментарий к заметке
– utilsGetServerTime:
- Возвращает текущее время на сервере ВКонтакте в unixtime.
+– notesRestoreComment:
+ Восстанавливает удалённый комментарий
@@ -3010,21 +3003,100 @@– notificationsGet:
- Возвращает список оповещений об ответах других пользователей на записи текущего пользователя.
+– wallGet:
+ Возвращает список записей со стены пользователя или сообщества
– notificationsMarkeAsViewed:
- Сбрасывает счетчик непросмотренных оповещений об ответах других пользователей на записи текущего пользователя.
+– wallGetByID:
+ Возвращает список записей со стен пользователей по их идентификаторам
+ + + +– wallSavePost:
+ Сохраняет запись на стене пользователя. Запись может содержать фотографию, ранее загруженную на сервер ВКонтакте, или любую доступную фотографию из альбома пользователя. +При запуске со стены приложение открывается в окне размером 607x412 и ему передаются параметры, описанные здесь.
+ + + +– wallPost:
+ Публикует новую запись на своей или чужой стене. +Данный метод позволяет создать новую запись на стене, а также опубликовать предложенную новость или отложенную запись.
+ + + +– wallRepost:
+ Копирует объект на стену пользователя или сообщества
+ + + +– wallGetReposts:
+ Позволяет получать список репостов заданной записи
+ + + +– wallEdit:
+ Редактирует запись на стене
+ + + +– wallDelete:
+ Удаляет запись со стены
+ + + +– wallRestore:
+ Восстанавливает удаленную запись на стене пользователя
+ + + +– wallGetComments:
+ Возвращает список комментариев к записи на стене пользователя
+ + + +– wallAddComment:
+ Добавляет комментарий к записи на стене пользователя или сообщества
+ + + +– wallDeleteComment:
+ Удаляет комментарий текущего пользователя к записи на своей или чужой стене
+ + + +– wallRestoreComment:
+ Восстанавливает комментарий текущего пользователя к записи на своей или чужой стене
@@ -3032,98 +3104,98 @@– boardGetTopics:
- Возвращает список тем в обсуждениях указанной группы.
+– accountGetCounters:
+ Возвращает ненулевые значения счетчиков пользователя
– boardGetComments:
- Возвращает список сообщений в указанной теме.
+– accountSetNameInMenu:
+ Устанавливает короткое название приложения (до 17 символов), которое выводится пользователю в левом меню.
– boardAddTopic:
- Создает новую тему в списке обсуждений группы.
+– accountSetOnline:
+ Помечает текущего пользователя как online на 15 минут.
– boardAddComment:
- Добавляет новое сообщение в теме сообщества.
+– accountImportContacts:
+ Принимает список контактов пользователя для поиска зарегистрированных во ВКонтакте пользователей методом friends.getSuggestions.
– boardDeleteTopic:
- Удаляет тему в обсуждениях группы
+– accountRegisterDevice:
+ Подписывает устройство на базе iOS, Android иди Windows Phone на получение Push-уведомлений.
– boardEditTopic:
- Изменяет заголовок темы в списке обсуждений группы
+– accountUnregisterDevice:
+ Отписывает устройство от Push уведомлений.
– boardEditComment:
- Редактирует одно из сообщений в теме группы
+– accountSetSilenceMode:
+ Отключает push-уведомления на заданный промежуток времени.
– boardRestoreComment:
- Восстанавливает удаленное сообщение темы в обсуждениях группы
+– accountGetPushSettings:
+ Позволяет получать настройки Push уведомлений.
– boardDeleteComment:
- Удаляет сообщение темы в обсуждениях сообщества
+– accountGetAppPermissions:
+ Получает настройки текущего пользователя в данном приложении.
– boardOpenTopic:
- Открывает ранее закрытую тему (в ней станет возможно оставлять новые сообщения).
+– accountGetActiveOffers:
+ Возвращает список активных рекламных предложений (офферов), выполнив которые пользователь сможет получить соответствующее количество голосов на свой счёт внутри приложения.
– boardCloseTopic:
- Закрывает тему в списке обсуждений группы (в такой теме невозможно оставлять новые сообщения)
+– accountBanUser:
+ Добавляет пользователя в черный список.
– boardFixTopic:
- Закрепляет тему в списке обсуждений группы (такая тема при любой сортировке выводится выше остальных)
+– accountUnbanUser:
+ Убирает пользователя из черного списка.
– boardUnfixTopic:
- Отменяет прикрепление темы в списке обсуждений группы (тема будет выводиться согласно выбранной сортировке)
+– accountGetBanned:
+ Возвращает список пользователей, находящихся в черном списке.
@@ -3270,122 +3342,43 @@– messagesSearchDialogs:
- Возвращает список найденных диалогов текущего пользователя по введенной строке поиска
- - - -– messagesAddChatUser:
- Добавляет в мультидиалог нового пользователя
- - - -– messagesRemoveChatUser:
- Исключает из мультидиалога пользователя, если текущий пользователь был создателем беседы либо пригласил исключаемого пользователя
- - - -– messagesGetLastActivity:
- Возвращает текущий статус и дату последней активности указанного пользователя
- - - -– messagesSetChatPhoto:
- Позволяет установить фотографию мультидиалога, загруженную с помощью метода photos.getChatUploadServer
- - - -– messagesDeleteChatPhoto:
- Позволяет удалить фотографию мультидиалога
- - - -– likesGetList:
- Получает список идентификаторов пользователей, которые добавили заданный объект в свой список Мне нравится.
- - - -– likesAdd:
- Добавляет указанный объект в список Мне нравится текущего пользователя
- - - -– likesDelete:
- Удаляет указанный объект из списка Мне нравится текущего пользователя
- - - -– likesIsLiked:
- Проверяет, находится ли объект в списке Мне нравится заданного пользователя.
- - - -– messagesSearchDialogs:
+ Возвращает список найденных диалогов текущего пользователя по введенной строке поиска
+ + + +– faveGetUsers:
- Возвращает список пользователей, добавленных текущим пользователем в закладки.
+– messagesAddChatUser:
+ Добавляет в мультидиалог нового пользователя
– faveGetPhotos:
- Возвращает фотографии, на которых текущий пользователь поставил отметку “Мне нравится”
+– messagesRemoveChatUser:
+ Исключает из мультидиалога пользователя, если текущий пользователь был создателем беседы либо пригласил исключаемого пользователя
– faveGetPosts:
- Возвращает записи, на которых текущий пользователь поставил отметку «Мне нравится»
+– messagesGetLastActivity:
+ Возвращает текущий статус и дату последней активности указанного пользователя
– faveGetVideos:
- Возвращает список видеозаписей, на которых текущий пользователь поставил отметку «Мне нравится»
+– messagesSetChatPhoto:
+ Позволяет установить фотографию мультидиалога, загруженную с помощью метода photos.getChatUploadServer
– faveGetLinks:
- Возвращает ссылки, добавленные в закладки текущим пользователем.
+– messagesDeleteChatPhoto:
+ Позволяет удалить фотографию мультидиалога
@@ -3393,23 +3386,21 @@– execute:
- Универсальный метод, который позволяет запускать последовательность других -методов, сохраняя и фильтруя промежуточные результаты.
+– statusGet:
+ Получает текст статуса пользователя или сообщества.
– executePredefinedProcedureWithName:options:
- Хранимые процедуры позволяют исполнять код на стороне сервера API аналогично -методу execute, но без передачи кода процедуры по сети.
+– statusSet:
+ Устанавливает новый статус текущему пользователю.
@@ -3417,296 +3408,309 @@– friendsGet:
- Возвращает список идентификаторов друзей пользователя или расширенную информацию о друзьях пользователя (при использовании параметра fields)
+– photosCreateAlbum:
+ Создает пустой альбом для фотографий
– friendsGetOnline:
- Возвращает список идентификаторов друзей пользователя, находящихся на сайте
+– photosEditAlbum:
+ Редактирует данные альбома для фотографий пользователя
– friendsGetMutual:
- Возвращает список идентификаторов общих друзей между парой пользователей
+– photosGetAlbums:
+ Возвращает список альбомов пользователя или сообщества
– friendsGetRecent:
- Возвращает список идентификаторов недавно добавленных друзей текущего пользователя
+– photosGet:
+ Возвращает список фотографий в альбоме
– friendsGetRequests:
- Возвращает информацию о полученных или отправленных заявках на добавление в друзья для текущего пользователя
+– photosGetAlbumsCount:
+ Возвращает количество доступных альбомов пользователя
– friendsAdd:
- Одобряет или создает заявку на добавление в друзья.
+– photosGetProfile:
+ Возвращает список фотографий со страницы пользователя или сообщества
– friendsEdit:
- Редактирует списки друзей для выбранного друга
+– photosGetByID:
+ Возвращает информацию о фотографиях по их идентификаторам
– friendsDelete:
- Удаляет пользователя из списка друзей или отклоняет заявку в друзья
+– photosGetUploadServer:
+ Возвращает адрес сервера для загрузки фотографий
– friendsGetLists:
- Возвращает список меток друзей текущего пользователя
+– photosGetProfileUploadServer:
+ Возвращает адрес сервера для загрузки фотографии на страницу пользователя
– friendsAddList:
- Создает новый список друзей у текущего пользователя
+– photosGetChatUploadServer:
+ Позволяет получить адрес для загрузки фотографий мультидиалогов
– friendsEditList:
- Редактирует существующий список друзей текущего пользователя
+– photosSaveProfilePhoto:
+ Сохраняет фотографию пользователя после успешной загрузки
– friendsDeleteList:
- Удаляет существующий список друзей текущего пользователя
+– photosSaveWallPhoto:
+ Сохраняет фотографии после успешной загрузки на URI, полученный методом photos.getWallUploadServer
– friendsGetAppUsers:
- Возвращает список идентификаторов друзей текущего пользователя, которые установили данное приложение
+– photosGetWallUploadServer:
+ Возвращает адрес сервера для загрузки фотографии на стену пользователя.
– friendsGetByPhones:
- Возвращает список друзей пользователя, у которых завалидированные или указанные в профиле телефонные номера входят в заданный список.
+– photosGetMessagesUploadServer:
+ Возвращает адрес сервера для загрузки фотографии в личное сообщение пользователю
– friendsDeleteAllRequests:
- Отмечает все входящие заявки на добавление в друзья как просмотренные
+– photosSaveMessagesPhoto:
+ Сохраняет фотографию после успешной загрузки на URI, полученный методом photos.getMessagesUploadServer
– friendsGetSuggestions:
- Возвращает список профилей пользователей, которые могут быть друзьями текущего пользователя.
+– photosSearch:
+ Осуществляет поиск изображений по местоположению или описанию
– friendsAreFriends:
- Возвращает информацию о том, добавлен ли текущий пользователь в друзья у указанных пользователей.
+– photosSave:
+ Сохраняет фотографии после успешной загрузки
-– searchGetHints:
- Метод позволяет получить результаты быстрого поиска по произвольной подстроке
+– photosEdit:
+ Изменяет описание у выбранной фотографии
-– audioGet:
- Возвращает список аудиозаписей пользователя или сообщества
+– photosMove:
+ Переносит фотографию из одного альбома в другой
– audioGetByID:
- Возвращает информацию об аудиозаписях
+– photosMakeCover:
+ Делает фотографию обложкой альбома
– audioGetLyrics:
- Возвращает текст аудиозаписи
+– photosReorderAlbums:
+ Меняет порядок альбома в списке альбомов пользователя
– audioSearch:
- Возвращает список аудиозаписей в соответствии с заданным критерием поиска
+– photosReorderPhotos:
+ Меняет порядок фотографии в списке фотографий альбома пользователя
– audioGetUploadServer:
- Возвращает адрес сервера для загрузки аудиозаписей
+– photosGetAll:
+ Возвращает все фотографии пользователя или сообщества в антихронологическом порядке
– audioSave:
- Сохраняет аудиозаписи после успешной загрузки
+– photosGetUserPhotos:
+ Возвращает список фотографий, на которых отмечен пользователь
– audioAdd:
- Копирует аудиозапись на страницу пользователя или группы
+– photosDeleteAlbum:
+ Удаляет указанный альбом для фотографий у текущего пользователя
– audioDelete:
- Удаляет аудиозапись со страницы пользователя или сообщества
+– photosDelete:
+ Удаление фотографии на сайте
– audioEdit:
- Редактирует данные аудиозаписи на странице пользователя или сообщества
+– photosConfirmTagWithCustomOptions:
+ Подтверждает отметку на фотографии
– audioReorder:
- Изменяет порядок аудиозаписи, перенося ее между аудиозаписями, идентификаторы которых переданы параметрами after и before
+– photosGetComments:
+ Возвращает список комментариев к фотографии
– audioRestore:
- Восстанавливает аудиозапись после удаления
+– photosGetAllComments:
+ Возвращает отсортированный в антихронологическом порядке список всех комментариев к конкретному альбому или ко всем альбомам пользователя
– audioGetAlbums:
- Возвращает список альбомов аудиозаписей пользователя или группы
+– photosCreateComment:
+ Создает новый комментарий к фотографии
– audioAddAlbum:
- Создает пустой альбом аудиозаписей
+– photosDeleteComment:
+ Удаляет комментарий к фотографии
– audioEditAlbum:
- Редактирует название альбома аудиозаписей
+– photosRestoreComment:
+ Восстанавливает удаленный комментарий к фотографии
– audioDeleteAlbum:
- Удаляет альбом аудиозаписей
+– photosEditComment:
+ Изменяет текст комментария к фотографии
– audioMoveToAlbum:
- Перемещает аудиозаписи в альбом
+– photosGetTags:
+ Возвращает список отметок на фотографии
– audioSetBroadcast:
- Транслирует аудиозапись в статус пользователю или сообществу
+– photosPutTag:
+ Добавляет отметку на фотографию
– audioGetBroadcastList:
- Возвращает список друзей и сообществ пользователя, которые транслируют музыку в статус
+– photosRemoveTag:
+ Удаляет отметку с фотографии
– audioGetRecommendations:
- Возвращает список рекомендуемых аудиозаписей на основе списка воспроизведения заданного пользователя или на основе одной выбранной аудиозаписи
+– photosGetNewTags:
+ Возвращает список фотографий, на которых есть непросмотренные отметки
+ + + +– faveGetUsers:
+ Возвращает список пользователей, добавленных текущим пользователем в закладки.
– audioGetPopular:
- Возвращает список аудиозаписей из раздела “Популярное”
+– faveGetPhotos:
+ Возвращает фотографии, на которых текущий пользователь поставил отметку “Мне нравится”
– audioGetCount:
- Возвращает количество аудиозаписей пользователя или сообщества
+– faveGetPosts:
+ Возвращает записи, на которых текущий пользователь поставил отметку «Мне нравится»
+ + + +– faveGetVideos:
+ Возвращает список видеозаписей, на которых текущий пользователь поставил отметку «Мне нравится»
+ + + +– faveGetLinks:
+ Возвращает ссылки, добавленные в закладки текущим пользователем.
@@ -3730,7 +3734,7 @@Делегат
+Delegate
Оффлайн режим. В данном режиме данные будут запрошены из кэша и возвращены -даже в случае истечения срока их действия (удаления не произойдет). -По умолчанию режим выключен.
+Offline mode, works for all requests. Current mode is used to return cache data even +if its lifetime ended, no deletion occurs (use this mode if no internet connection exists).
Defaults to NO.
+Начинать ли выполнение запросов немедленно или предоставить программисту -самому выбирать момент запуска запроса. -По умолчанию принимает значение YES.
+Allows developer to initiate immediate request start after its being created. +Defaults to YES.
Предположим, что вы хотите осуществить запрос пользовательской информации, но -начало хотите инициировать сами. Вот, как это может выглядеть:
+For instance, you want to request user’s information and initiate request when +user taps a button. Here is how it can be implemented:
VKRequestManager *rm = [[VKRequestManager alloc] init...];
rm.startAllRequestsImmediately = NO;
VKRequest *userInfo = [rm info];
+
-// пользователь нажал какую-то кнопку, после чего вы стартуете запрос
-[userInfo start];
+User taps a button and this method is called:
+ +[userInfo start];
-Если нет необходимоти выполнять отложенный запуск, то можно делать следующим образом:
+If there is not need to perform delayed requests than you should just call needed +method and don’t bother about something else. Looks like:
-// запрос стартует немедленно
+VKRequestManager *rm = [[VKRequestManager alloc] init...];
[rm info];
Пользователь от лица которого осуществляются запросы.
+User from whose face requests are made.
В случае, если ползовательский объект равен nil запрос будет осуществлен без -передачи токена доступа.
+If the user property equals nil than no access token is added.
Инициализация менеджера запросов
+Designated initialization method.
делегат
delegate, should conform to VKRequestDelegate
пользователь от лица которого будут осуществляться запросы
user from whose face requests are made
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-15)
+
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-20)
Generated by appledoc 2.1 (build 858).
Класс представляет собой хранилище для пользовательских токенов доступа и -закэшированных данных. -Основным хранимым элементом является элемент типа VKStorageItem, который содержит -пользовательский токен доступа и связанную с ним директорию для кэша.
+Class manages user access tokens and corresponding cached data.
isEmpty
- Является ли хранилище пустым
+Is current storage empty?
property count
- Кол-во элементов находящихся в хранилище
+Size of VKStorage storage (number of objects in it)
property fullStoragePath
- Полный путь к основной директории хранилища
+Full path to main storage directory
property fullCacheStoragePath
- Полный путь к основной директории кэша хранилища
+Full path to main cache directory
property @@ -231,14 +228,14 @@+ sharedStorage
- Общее хранилище
+Shared storage
@@ -246,14 +243,14 @@– createStorageItemForAccessToken:
- Создаёт элемент хранилища
+Creates new VKStorageItem
@@ -261,35 +258,35 @@– storeItem:
- Добавляет в хранилище новый элемент
+Adds new element to VKStorage
– removeItem:
- Удаляет из хранилища указанный элемент
+Removes VKStorageItem from VKStorage.
– clean
- Удаляет все данные из хранилища.
+Clears storage.
– cleanCachedData
- Удаляет все данные кэша в хранилище
+Removes all cached data for all users.
@@ -297,21 +294,21 @@– storageItemForUserID:
- Получение элемента хранилища по пользовательскому идентификатору
+Returns user’s corresponding VKStorageItem by unique user identifier
– storageItems
- Список всех элементов хранилища
+List of all items in current storage
@@ -335,7 +332,7 @@Кол-во элементов находящихся в хранилище
+Size of VKStorage storage (number of objects in it)
Полный путь к основной директории кэша хранилища
+Full path to main cache directory
Полный путь к основной директории хранилища
+Full path to main storage directory
Является ли хранилище пустым
+Is current storage empty?
Общее хранилище
+Shared storage
экземпляр класс VKStorage
+shared instance of VKStorage class
Удаляет все данные из хранилища.
+Clears storage.
Удаляет все данные кэша в хранилище
+Removes all cached data for all users.
Создаёт элемент хранилища
+Creates new VKStorageItem
пользовательский токен доступа для которого будет создан элемент хранилища
VKAccessToken for which new storage item will be created
Удаляет из хранилища указанный элемент
+Removes VKStorageItem from VKStorage.
элемент хранилища
item to remove from VKStorage
Получение элемента хранилища по пользовательскому идентификатору
+Returns user’s corresponding VKStorageItem by unique user identifier
пользовательский идентификатор
unique user identifier
экземпляр класса VKStorageItem, либо nil, если элемента в хранилище
+instance of VKStorageItem, or nil, if there is no such.
Список всех элементов хранилища
+List of all items in current storage
Добавляет в хранилище новый элемент
+Adds new element to VKStorage
элемент хранилища
new item to be added
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-15)
+
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-20)
Generated by appledoc 2.1 (build 858).
Класс представляет собой элемент хранилища VKStorage.
+Current class is used as an item of main VKStorage storage, which +persists data such as access tokens and cache.
accessToken
- Токен доступа
+Access token
property cache
- Кэш запросов
+Cache
property @@ -165,14 +166,14 @@– initWithAccessToken:mainCacheStoragePath:
- Инициализация элемента хранилища токеном доступа и директорией кэша
+Initialization method
@@ -196,7 +197,7 @@Токен доступа
+Access token
Кэш запросов
+Cache
Инициализация элемента хранилища токеном доступа и директорией кэша
+Initialization method
токен доступа с которым будет ассоциироваться элемент хранилища
access token which will be used as key in VKStorage storage
путь к директории в которой необходимо хранить кэш запросов
directory which will be used for cached data
экземпляр класс VKStorageItem
+instance of VKStorageItem class
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-15)
+
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-20)
Generated by appledoc 2.1 (build 858).
Класс представляет пользователя социальной сети, который может осуществлять ряд -действий с объектами вроде групп, друзей, музыкой, видео и тд.
- -Класс так же позволяет изменить текущего активного пользователя на одного из -пользователей находящихся в хранилище (ранее авторизованных). Получить список -пользователей, которые авторизовывались можно используя метод localUsers.
Warning: методы, которые требуют наличия access_token в запросе перезаписывают -токен доступа, если таковой был указан при передаче словаря ключей-значений, на -значение токена доступа текущего пользователя - self.accessToken.token.
Warning: по умолчанию у каждого запроса из класса VKUser подпись (signature) -является строкой селектора инициировавшего/создавшего объекта запроса
Manages users
accessToken
- Пользовательски токен доступа текущего активного пользователя
+User’s access token
property @@ -181,28 +173,28 @@+ currentUser
- Текущий активный пользователь.
+Current activated user
+ activateUserWithID:
- Делает активным пользователя с идентификатором userID.
+Activates user with passed unique user identifier
+ localUsers
- Получение списка пользователей находящихся в хранилище
+List of users which were saved in VKStorage
@@ -210,14 +202,14 @@– description
- Описание текущего пользователя
+Description of current user
@@ -241,7 +233,7 @@Пользовательски токен доступа текущего активного пользователя
+User’s access token
Делает активным пользователя с идентификатором userID.
+Activates user with passed unique user identifier
идентификатор пользователя, которого необходимо активировать
unique user identifier, user which should be activated
булево значение, удалось ли активировать указанного пользователя или нет
+YES - if user was activated, NO - otherwise
Если пользователя с таким идентификатором нет в хранилище, то метод вернет NO, иначе -YES.
+If there is no such user then NO will be returned, otherwise - YES.
Текущий активный пользователь.
+Current activated user
Если хранилище не содержит авторизованных пользователей, то возвращено будет значение -nil.
+If there is no users in VKStorage then nil will be returned. +If no user was activated, then random user will be activated.
-В случае, если активным не был установлен какой-то определенный пользователь, то -при вызове данного метода активируется произвольный пользователь из хранилища (если -в хранилище будет находится лишь один пользователь, то именно он будет активирован -и от его лица будут осуществляться дальнейшие запросы).
+Lets assume we have such situation:
-Вопрос: Когда может произойти подобная ситуация?
- -Ответ: Представим, что два и более пользователей подряд авторизовались и, во время -авторизаций не было вызовов метода currentUser.
- -Рассмотрим на примере:
- -// авторизовался пользователь А
-// авторизовался пользователь Б
-// авторизовался пользователь В
-[VKUser currentUser] // будет активирован произвольный пользователь, либо А, либо Б, либо В
+// user A authorized
+// user B authorized
+// user C authorized
+[VKUser currentUser] // random user will be activated - A or B or C
-Второй пример:
+Second example:
-// авторизовался пользователь А
-[VKUser currentUser] // активным устанавливается пользователь А
-// авторизовался пользователь Б, но А по прежнему активный
-// авторизовался пользователь В, но А по прежнему активный
+// user A authorized
+[VKUser currentUser] // user A becomes active user
+// user B authorized, but A is still active
+// user C authorized, but A is still active
+// so on.
Получение списка пользователей находящихся в хранилище
+List of users which were saved in VKStorage
массив пользовательских идентификаторов
+list of users (@(NSUInteger) objects - user unique identifiers)
Описание текущего пользователя
+Description of current user
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-15)
+
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-20)
Generated by appledoc 2.1 (build 858).
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-15)
+
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-20)
Generated by appledoc 2.1 (build 858).
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-15)
+
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-20)
Generated by appledoc 2.1 (build 858).
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-15)
+
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-20)
Generated by appledoc 2.1 (build 858).
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-15)
+
© 2013 AndrewShmig. All rights reserved. (Last updated: 2013-11-20)
Generated by appledoc 2.1 (build 858).