Правила использования API ВКонтакте. — Лунная База
Используя публичный API ВКонтакте, Вы соглашаетесь с перечисленными Правилами платформы.
Мы оставляем за собой право без уведомления полностью или частично прекратить доступ приложения к публичному API (в том числе путём блокировки приложения) в случае нарушений.
Эта правила распространяются на любые способы использования публичного API. Кроме того, в отдельных случаях применяются дополнительные соглашения и требования:
- Требования для модерации приложений — дополнительные требования для игровых приложений, претендующих на попадание в каталоги.
- Правила размещения рекламы в приложениях — правила размещения рекламы в приложениях из каталогов.
- Правила размещения приложений-магазинов — правила размещения в каталоге приложений с продажей товаров и услуг.
- Правила размещения рекламных приложений — правила для рекламных приложений, претендующих на попадание в каталоги.
- Правила размещения Приложений сообществ — правила для приложений сообществ, претендующих на попадание в каталог.
Термины и определения
1. Социальная Сеть ВКонтакте (или Социальная Сеть) — социальная сеть, известная под именем «ВКонтакте», размещенная на сайте в сети Интернет по адресу: VK.com (включая все уровни указанного домена, как функционирующие на дату принятия Пользователем настоящих Правил, так и запускаемые и вводимые в эксплуатацию в течение всего срока его действия) и доступная Пользователю через сайт, мобильную версию сайта, приложения и иные ресурсы, представляющая результат интеллектуальной деятельности в форме программы для ЭВМ, являющейся помимо прочего уникальной базой данной ВКонтакте. Социальная Сеть представлена в объективной форме совокупностью данных и команд, и порождаемых аудиовизуальных отображений (включая входящие в ее состав графические изображения и пользовательский интерфейс), (далее – данные и команды), предназначенных для функционирования ЭВМ и мобильных устройств в целях получения определенного результата в виде организации функционала социальной сети. Совокупность данных и команд состоит из активированных и неактивированных данных и команд.
2. Публичный API — совокупность программных средств для работы с данными Социальной Сети посредством HTTP-запросов. Под методами публичного API понимаются методы, перечисленные на странице https://vk.com/dev/methods. Доступ к Публичному API предоставляется на безвозмездной основе и может быть прекращён полностью или частично без уведомления и объяснения причин.
3. Приложение — программный продукт для работы с Публичным API, представляющий собой сайт или автономную программу, зарегистрированный посредством формы https://vk.com/editapp?act=create и имеющий в Социальной Сети уникальный идентификатор (API_ID).
1. Функциональность приложения
1.1. Приложение не должно обманывать пользователей.
Не стоит обещать бесплатные голоса или просмотр гостей страницы.
1.2. Приложение не должно содержать функций, при работе с которыми пользователь нарушает Правила пользования Социальной Сетью ВКонтакте (https://vk. com/terms).
Например, приложение для помощи в накрутке лайков — плохая идея.
1.3. В Приложении не должно быть ссылок, опасных для пользователей. Все переходы по ссылкам должны быть предсказуемы.
Если в Вашем приложении много разных ссылок от пользователей, используйте метод utils.checkLink, чтобы проверить их безопасность.
1.4. Приложение не может быть выдано за официальный продукт разработчиков ВКонтакте. В том числе, запрещается задействовать логотип, подарки или стикеры ВКонтакте в оформлении, использовать название ВКонтакте в названии или описании Приложения, если иное не оговорено отдельным дополнительным соглашением.
1.5. Нельзя резко изменять суть и название приложения.
Если есть такая необходимость, зарегистрируйте новое. Пользователи будут неприятно удивлены, обнаружив у себя в списке какое-то незнакомое приложение.
1.6. Нельзя предоставлять возможность скачивать контент (например, аудиозаписи, видеозаписи, изображения, документы и иной контент) с серверов ВКонтакте за рамками предоставляемой Социальной Сетью ВКонтакте функциональности с целью предоставления доступа к контенту в оффлайн-режиме или создания с использованием такого контента автономных хранилищ.
Это нарушает интересы Администрации Сайта, пользователей и(или) правообладателей.
1.7. Приложение не должно содержать сторонних библиотек, фрагментов кода, не имеющих прямого отношения к его функционированию, в том числе эксплуатирующих вычислительные мощности устройства пользователя без его ведома.
Тайком майнить криптовалюту — нельзя.
2. Работа с данными
Мы трепетно относимся к данным наших пользователей и ожидаем от Вас того же. Приложениям запрещено:
2.1. Собирать и хранить пользовательские данные, включая идентификатор пользователя (User ID), в целях, не связанных с функционированием Приложения. Запрашиваемые данные должны использоваться только в контексте приложения.
Например, кэшировать идентификаторы друзей пользователя, чтобы быстрее отображать список на мобильном устройстве — можно. Передавать идентификаторы всех пользователей к себе на сервер, чтобы хранить в собственной базе на всякий случай — нельзя.
2. 2. Передавать любые пользовательские данные, автоматизированно полученные через API (включая User ID), сторонним сервисам (например, рекламным) как напрямую, так и через посредников.
2.3. Использовать пользовательские данные в любых рекламных объявлениях.
Например, обращаться к пользователю по имени из рекламного баннера. Не надо так.
2.4. Данные, полученные через API, в т.ч. методами newsfeed.search, wall.get, wall.search, в т.ч. идентификаторы пользователей (User ID), не могут использоваться в целях передачи или перепродажи, создания аналитических отчётов, скоринга и т.д., напрямую или через посредников, без прямого согласия Администрации сайта.
Таким согласием, например, может быть договор с рекламным агентством на использование данных о показах рекламных объявлений в отчётах клиентам.
2.5. Доступ к расширенной версии Streaming API для некоммерческих исследований может быть предоставлен на безвозмездной основе по согласованию с Администрацией сайта. Данные, полученные с использованием расширенной версии Streaming API в рамках некоммерческого исследования, запрещено использовать для перепродажи третьим лицам в исходном или обработанном виде (например, в форме аналитического отчёта, баллов скоринга, иных аггрегированных форм).
3. Содержание приложений
3.1. Запрещается нарушать права и интересы третьих лиц. Если в Приложении используются чьи-то торговые марки, копирайты, персонажи и любой иной контент, исключительные права на который принадлежат третьим лицам-правообладателям, это необходимо согласовать с правообладателем — так, чтобы по нашему запросу Вы могли предоставить разрешение на использование этих материалов.
Убедитесь в том, что автор не возражает против использования его работы в Вашем приложении.
3.2. Запрещается размещать чужие Приложения и разработки в отсутствие заключенного надлежащим образом соглашения с правообладателем, а также полностью копировать функциональность других Приложений.
Мы за честную конкуренцию.
3.3. Приложение должно содержать информацию о его возрастных ограничениях.
Если в Вашем приложении есть контент, который не стоит показывать детям, упомяните об этом. Напоминаем, что законом предусмотрены следующие маркировки: 0+, 6+, 12+, 16+ и 18+.
4. Использование платформы
4.1. Оповещения, которые Приложение отправляет пользователю, не должны содержать не относящейся к Приложению посторонней информации или спама.
Реклама в оповещениях — верный путь к ненависти. Выбирайте другие способы монетизации.
4.2. Приложение не должно вызывать какие-либо активные действия в API без ведома пользователей и без их согласия.
Пользователь всегда должен знать, что произойдёт после нажатия на кнопку. Уделите особое внимание публикациям на стену и работе с сообщениями. Пользователь не простит Вам запись, опубликованную без его ведома, или случайно удалённый навечно диалог.
4. 3. Запрещается стимулировать пользователей выполнять публикацию записей на стенах (в том числе на собственной), рассылку приглашений другим пользователям, рассылку заявок в друзья случайным людям и другие действия, затрагивающие прямым или косвенным образом других людей. Допустимый для нас вариант — бонусы пользователям, друзья которых установили приложение, и награда за вступление в официальное сообщество Приложения.
4.4. Приложение, которое использует данные о связях между пользователями ВКонтакте («социальный граф»), полученные с помощью API, должно содержать активные ссылки на профили пользователей на сайте vk.com или в официальном мобильном приложении ВКонтакте (URL-схема vk://). Активная ссылка должна быть доступна при просмотре информации о пользователе приложения на главном экране личного профиля или аналогичного раздела. Отображение ссылки может быть отключено владельцем профиля. Исключение составляют приложения, размещённые на vk.com и в мобильном игровом каталоге, неофициальные клиенты ВКонтакте или приложения, расширяющие функциональность ВКонтакте.
4.5. Приложение, содержащее функциональность ленты новостей, должно корректным образом отображать рекламные записи, формировать статистику взаимодействия пользователей с такими записями и отправлять её Сайту с помощью соответствующего метода публичного API. При несоответствии приложения указанным требованиям (Требования к отображению рекламных записей) Сайт оставляет за собой право прекратить доступ Приложения к публичному API или его отдельным составляющим.
5. Лицензия
5.1. Размещая приложение на vk.com и в мобильном html5-каталоге, Вы предоставляете ВКонтакте на условиях безвозмездной простой неисключительной лицензии право использования приложения в виде размещения его в свободном доступе и для всеобщего сведения в Социальной Сети без ограничения по территории.
5.2. ВКонтакте вправе передавать без ограничения по территории права использования приложения Пользователям посредством их сублицензирования на условиях стандартного Лицензионного соглашения, заключаемого между ВКонтакте и Пользователями посредством размещения ВКонтакте публичной оферты в Социальной Сети. Вы подтверждаете, что ознакомлены с текстом указанного Лицензионного соглашения и не имеете возражений против предоставления ВКонтакте прав использования приложения, размещенного на vk.com, Пользователям на условиях указанного Лицензионного соглашения. Вы предоставляете ВКонтакте право использования приложением, размещенного на vk.com без ограничения по территории следующими способами: :(а) доведение приложения до всеобщего сведения в сети Интернет таким образом, что любое лицо может получить доступ к приложению из любого места и в любое время; :(б) рекламирование и продвижение приложения любым способом без ограничений, в т.ч. посредством размещения рекламных материалов, созданных с использованием изображения интерфейса приложения.
5.3. Права использования приложения согласно пп. 5.1 и 5.2 выше предоставляются сроком на 5 лет с последующей автоматической пролонгацией данного срока на каждый последующий календарный год, в случае если ни одна из сторон договора не выразит волеизъявление о его досрочном расторжении не позднее, чем за 30 календарных дней до момента такого расторжения.
5.4. ВКонтакте не предоставляет никаких дополнительных отчетов об использовании приложения, за исключением согласованного в договоре.
5.5. Вы настоящим гарантируете, что :(а) являетесь правообладателем приложения, размещенного Вами на vk.com (либо правообладателем приложения является лицо, дополнительно указанное Вами), :(б) предоставление ВКонтакте прав использования приложения, размещенного на vk.com, в соответствии с настоящим разделом 6 не нарушает и не будет нарушать условия каких-либо Ваших сделок с третьими лицами и/или права третьих лиц, :(в) использование ВКонтакте и/или Вами приложения, размещенного на vk.com, в соответствии с договором не нарушает прав третьих лиц, включая, но не ограничиваясь только этим, авторские права, смежные права, права на товарные знаки и иные средства индивидуализации, а равно личные неимущественные права физических лиц.
6. Иные положения
6.1. Правила могут изменяться и дополняться по мере необходимости. ВКонтакте рекомендует регулярно проверять условия настоящих Правил на предмет их изменения и/или дополнения. Продолжение размещения приложения в Социальной Сети после внесения изменений и/или дополнений в настоящие Правила означает принятие и согласие с такими изменениями и/или дополнениями.
6.2. Размещая приложение ВКонтакте, разработчик принимает Правила размещения рекламы в приложениях, Правила размещения магазинов в приложениях, а также Правила размещения рекламных приложений.
Настоящие Правила являются неотъемлемой частью:
— Договора оказания услуг (для размещения приложений в мобильных клиентах ВКонтакте);
— Условий размещения приложений на сайте vk.com.
Заберите ссылку на статью к себе, чтобы потом легко её найти!
Раз уж досюда дочитали, то может может есть желание рассказать об этом месте своим друзьям, знакомым и просто мимо проходящим?
Не надо себя сдерживать! 😉
Собираем данные по рекламным кампаниям ВКонтакте
В пятничном лонгриде проделаем большую работу: возьмём информацию по рекламным кампаниям ВКонтакте и сопоставим их с данными Google Analytics в Redash. Чтобы снова не поднимать сервер, будем передавать данные через Google Docs, используя Spreadsheet API.
Получение access token
Для получение пользовательского ключа ВКонтакте нужно создать приложение. Идём в раздел «Разработчики» по https://vk.com/apps?act=manage, жмём на кнопку «Создать приложение». В поле «Тип приложения» выбираем «Standalone-приложение» и даём любое название. После этого в меню слева идём в настройки и сохраняем себе ID приложения.
Актуальную информацию о ключах можно посмотреть в статье « Получение ключа доступа»
Теперь копируем себе эту ссылку:
https://oauth.vk.com/authorize?client_id=YourClientID&scope=ads&response_type=token
Но вместо YourClientID вставляем ID своего созданного приложения. В scope у этой ссылки только ads, так что с этим ключом можно будет получать только информацию о рекламном кабинете. Вставляем её в браузер и нас скидывает на другую страницу — в адресе этой странице будет указан ваш сгенерированный access token.
Срок жизни токена — 86400 секунд: ровно сутки. Чтобы получить токен без временных ограничений можно добавить в scope параметр offline. Если токен понадобилось отозвать — смените пароль от страницы или в настройках безопасности завершите активные сессии.
Ещё для запросов к API нам пригодится ID рекламного кабинета — проходим по https://vk.com/ads?act=settings и копируем «номер кабинета».
Сбор данных через запросы к API
Напишем скрипт, который обращается к серверу ВКонтакте с нашим access token и номером рекламного кабинета и берёт информацию о всех кампаниях пользователя: количество просмотров на рекламах, кликов и затрат. Затем скрипт будет формировать из него DataFrame и отправлять в Google Docs.
from oauth3client.service_account import ServiceAccountCredentials from pandas import DataFrame import requests import gspread import time
Зададим несколько константных значений: access token, ID рекламного кабинета и версию API ВКонтакте, которую будем использовать. Актуальной является версия 5.103.
token = 'fa258683fd418fafcab1fb1d41da4ec6cc62f60e152a63140c130a730829b1e0bc' version = 5.103 id_rk = 123456789
За получение статистики по рекламе отвечает метод ads.getStatistics, но один из обязательных параметров при его вызове — ’ids’, ID рекламного объявления, статистику по которому мы хотим получить. Так как ID у нас пока нет, придётся сначала воспользоваться методов ads.getAds, который возвращает ID объявлений и кампаний.
Подробнее со всеми методами ВКонтакте API можно ознакомиться в документации
Библиотекой requests отправляем запрос к серверу и передаём свои параметры. Полученный ответ сразу переведём в формат json
campaign_ids = [] ads_ids = [] r = requests.get('https://api.vk.com/method/ads.getAds', params={ 'access_token': token, 'v': version, 'account_id': id_rk }) data = r.json()['response']
Вот, как выглядит объект data: нам вернулся обычный список словарей, с которым мы уже имели дело в материале “Передаём и анализируем собранные данные по рекламным капманиям в Redash”.
Заполняем словарь ad_campaign_dict. Ключом будет ID объявления, а значением — ID кампании, к которой принадлежит объявление. Так будет удобнее присваивать к объявлению ID кампании, к которой оно принадлежало.
ad_campaign_dict = {} for i in range(len(data)): ad_campaign_dict[data[i]['id']] = data[i]['campaign_id']
Теперь, имея ID каждого нужного объявления, можно обратиться к методу ads.getStatistics. Мы будем собирать количество просмотров, кликов, затрат и даты начала и конца объявления, поэтому заблаговременно заведём пустые списки.
ads_campaign_list = [] ads_id_list = [] ads_impressions_list = [] ads_clicks_list = [] ads_spent_list = [] ads_day_start_list = [] ads_day_end_list = []
Вызывать getStatistics нужно отдельно для каждого объявления — будем делать это в итераторе по ad_campaign_dict. Отправляем запрос, передавая в ‘period’ значение ‘overall’ — берём данные за всё время. У некоторых объявлений могут отсутствовать данные по полю «Просмотры» или «Клики» если они не были запущены, и, потребовав их, мы словим KeyError — во избежание этого добавим обработчик try — except, который заставит скрипт не обращать внимания на эту ошибку.
for ad_id in ad_campaign_dict: r = requests.get('https://api.vk.com/method/ads.getStatistics', params={ 'access_token': token, 'v': version, 'account_id': id_rk, 'ids_type': 'ad', 'ids': ad_id, 'period': 'overall', 'date_from': '0', 'date_to': '0' }) try: data_stats = r.json()['response'] for i in range(len(data_stats)): for j in range(len(data_stats[i]['stats'])): ads_impressions_list.append(data_stats[i]['stats'][j]['impressions']) ads_clicks_list.append(data_stats[i]['stats'][j]['clicks']) ads_spent_list.append(data_stats[i]['stats'][j]['spent']) ads_day_start_list.append(data_stats[i]['stats'][j]['day_from']) ads_day_end_list.append(data_stats[i]['stats'][j]['day_to']) ads_id_list.append(data_stats[i]['id']) ads_campaign_list.append(ad_campaign_dict[ad_id]) except KeyError: continue
Теперь сформируем из списков DataFrame и выведем первые 5 элементов:
df = DataFrame() df['campaign_id'] = ads_campaign_list df['ad_id'] = ads_id_list df['impressions'] = ads_impressions_list df['clicks'] = ads_clicks_list df['spent'] = ads_spent_list df['day_start'] = ads_day_start_list df['day_end'] = ads_day_end_list print(df.head())
Экспорт данных в Google Docs
Для экспорта DataFrame в таблицу Google Sheets необходим ключ доступа Google API. Пройдём по https://console.developers.google.com и создадим новый проект. Даём ему любое имя и в Dashboard жмём на кнопку “Подключить API и сервисы”. Нужно включить два API — Google Drive API и Google Sheets API. Ищем первый в поиске, нажимаем на “Включить API”, затем ищем второй и проделываем то же самое.
После включения нас отправят на панель управления API. Жмём на «Создать учётные данные» — по ним будем проводить авторизацию в скрипте. Отмечаем, что используем Google Sheets API из веб-сервера и обращаемся к данным пользователя. Нажимаем на «Выбрать тип учётных данных» и создаем сервисный аккаунт. В поле «Роль» выбираем Проект — Редактор, а тип ключа оставим JSON.
После этого нам отправят файл в формате JSON с нашими учетными данными — назовём его «credentials.json» — и перенаправят на страницу с сервисными аккаунтами. Ниже будет поле с почтой — копируем её себе.
Переходим по https://docs.google.com/spreadsheets и создаем пустой файл с названием data, в который будут отправляться данные из DataFrame. В настройках доступа даём доступ по почте, скопированной ранее из сервисных аккаунтов — от неё будут приходить данные из скрипта.
Закинем файл credentials.json в директорию со скриптом и продолжим писать код. Перечисляем область видимости в виде ссылок:
scope = ['https://spreadsheets. google.com/feeds', 'https://www.googleapis.com/auth/drive']
И при помощи библиотек oauth3client и gspread проводим авторизацию методами ServiceAccountCredentials.from_json_keyfile_name и gspread.authorize, указывая в параметрах первого наш файл и переменную scope. Через переменную sheet будем обращаться к нашему файлу в Google Docs.
creds = ServiceAccountCredentials.from_json_keyfile_name('credentials.json', scope) client = gspread.authorize(creds) sheet = client.open('data').sheet1
Для ввода значений в ячейку таблички есть метод update_cell. Важно: нумерация индексов ячеек при обращении начинается не с нуля, а с единицы. Первым циклом пройдём по первой строке и перенесем туда заголовки нашего DataFrame. Во втором будем идти по каждой ячейке и вставлять соответствующие значения DataFrame. По умолчанию стоит ограничение — 100 запросов в 100 секунд. Это ограничение может остановить наш скрипт на полпути: чтобы избежать ошибки пропишем time.sleep, чтобы после каждой вставки скрипт секунду выжидал.
count_of_rows = len(df) count_of_columns = len(df.columns) for i in range(count_of_columns): sheet.update_cell(1, i + 1, list(df.columns)[i]) for i in range(1, count_of_rows + 1): for j in range(count_of_columns): sheet.update_cell(i + 1, j + 1, str(df.iloc[i, j])) time.sleep(1)
Если всё сделаем правильно — получим таблицу такого вида:
Экспорт данных в Redash
Подключение Google Analytics к Redash описано в статье «Как подключить Google Analytics как Redash?».
Имея в Redash таблицу с Google Analytics и рекламным кампаниям ВКонтакте, можем сопоставить их друг другу. Напишем такой запрос:
SELECT query_50.day_start, CASE WHEN ga_source LIKE '%vk%' THEN 'vk.com' END AS source, query_50.spent, query_50.impressions, query_50.clicks, SUM(query_49.ga_sessions) AS sessions, SUM(query_49.ga_newUsers) AS users FROM query_49 JOIN query_50 ON query_49. ga_date = query_50.day_start WHERE query_49.ga_source LIKE '%vk%' AND DATE(query_49.ga_date) BETWEEN '2020-05-16' AND '2020-05-20' GROUP BY query_49.ga_date, source
ga_source — источник, с которого человек пришел на сайт. Всё, что похоже на vk оператором CASE объединяем в столбец «vk.com». Оператором JOIN добавляем таблицу с данными из ВКонтакте, объединяя по полю даты. Отсеиваем данные — возьмём день последней рекламной кампании и посмотрим на несколько дней после него. На выходе получим таблицу такого вида:
Итоги
Получилась таблица, сообщающая, сколько всего было затрачено на объявления в этот день, сколько человек его посмотрели, зашли к нам на сайт и стали нашими новыми пользователями.
Интеграция vk API с Google Search Console API
Обзор/
Приложения/
vk/
Google Search ConsoleНастройте триггер vk API для запуска рабочего процесса, который интегрируется с Google Search Console API. Интеграционная платформа Pipedream позволяет удивительно быстро интегрировать vk и Google Search Console.
Бесплатно для разработчиков.Обзор vk#
ВКонтакте, ранее известная как Вконтакте, — это популярная российская социальная сеть
, которая предлагает обширный набор веб-API для разработчиков.
Используя API ВКонтакте, разработчики могут создавать ряд приложений и сервисов
, которые могут взаимодействовать с пользователями и ресурсами ВКонтакте. С помощью VK API разработчики
могут создавать различные сервисы, начиная от традиционных функций социальных сетей
и заканчивая более сложными приложениями и играми.
Вот некоторые вещи, которые можно создать с помощью VK API:
- Платформы социальных сетей: Дайте пользователям возможность устанавливать связи, отправлять сообщения,
обмениваться мультимедиа, а также создавать группы и события и управлять ими. Платформы потоковой передачи музыки и видео - : Создавайте платформы потоковой передачи музыки и видео
с поддержкой потоковой передачи популярного аудио- и видеоконтента из ВКонтакте. - Games: реализуйте полнофункциональные игровые приложения, которые можно интегрировать с
VK для категорий лидеров, игровых сообществ и многого другого. - Чат-боты: Создайте своего личного чат-бота для пользователей ВКонтакте,
позволяя им общаться с другими пользователями ВКонтакте в автоматическом режиме. - Электронная коммерция: используйте VK API для создания онлайн-рынков и электронной коммерции
магазинов с интеграцией ВКонтакте. - Геолокационные службы: разрабатывайте приложения, которые можно использовать для определения местоположения и
обмена событиями, местами и достопримечательностями с пользователями ВКонтакте. - Аналитика и отслеживание: собирайте данные и внедряйте аналитические инструменты для пользователей и предприятий VK
. - Реклама и продвижение: разрабатывайте кампании и рекламные мероприятия с интеграцией
ВКонтакте. - Персонализация. Разрешите пользователям настраивать свой опыт ВКонтакте с помощью различных
методов, включая пользовательские скины, макеты страниц и многое другое.
Connect vk#
1
2
3
4
5
6
7
9 0002 89
10
11
12
13
14
15
16
17
18
19
20
21
import { axios } from "@pipedream/platform" экспортировать по умолчанию defineComponent({ реквизит: { вк: { тип: "приложение", приложение: "вк", } }, асинхронный запуск ({шаги, $}) { возврат ожидания axios($, { адрес: `https://api.vk.com/method/users.get`, заголовки: { Авторизация: `Bearer ${this.vk.$auth.oauth_access_token}`, }, параметры: { "в": `5.131`, }, }) }, })
Обзор Google Search Console#
Вы можете использовать API Google Search Console для создания различных инструментов и
приложений. Вот несколько примеров:
- Инструмент, который извлекает данные из Google Search Console API и отображает их
в удобном для пользователя интерфейсе. - Панель инструментов, которая визуализирует данные, полученные из API Google Search Console.
- Инструмент, который позволяет пользователям вводить запрос и получать результаты от Google
Search Console API в режиме реального времени.
Использование и передача компанией Pipedream информации, полученной от API Google, в любое другое приложение будет осуществляться в соответствии с Политикой данных пользователей служб API Google, включая требования ограниченного использования.
Connect Google Search Console#
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
import { axios } from "@pipedream/platform" экспортировать по умолчанию defineComponent({ реквизит: { google_search_console: { тип: "приложение", приложение: "google_search_console", } }, асинхронный запуск ({шаги, $}) { возврат ожидания axios($, { URL-адрес: `https://www. googleapis.com/webmasters/v3/sites`, заголовки: { Авторизация: `Bearer ${this.google_search_console.$auth.oauth_access_token}`, }, }) }, })
Использование сетевых API в Monarch
Что такое сетевые API?
Сетевые APIпозволяют Monarch автоматически получать количество подписчиков из ваших профилей в социальных сетях и отображать их на вашем веб-сайте. Это означает, что для сетей, которые его поддерживают, вам никогда не придется обновлять количество подписчиков, поскольку плагин постоянно проверяет API и кэширует счетчик для вас. Только определенные сети поддерживают вызовы API, и каждую из них нужно настраивать немного по-разному. Чтобы ознакомиться с полным списком поддерживаемых сетей и инструкциями по их установке, продолжайте читать.
Прежде чем вы сможете настроить параметры API, вы должны сначала убедиться, что у вас включен параметр «Получить счетчики через API» на вкладке «Сети» панели настроек Monarch. После включения вы можете начать настройку каждой учетной записи, как описано ниже.
Твиттер
Twitter использует OAuth для своего API, а это означает, что требуется несколько дополнительных шагов аутентификации, прежде чем Monarch сможет получить доступ к информации вашего профиля. Чтобы начать процесс, сначала войдите в свою учетную запись Twitter.com, а затем войдите в диспетчер приложений. Здесь вам нужно будет заполнить несколько полей, как указано ниже:
Имя
Это может быть что угодно. Просто что-то на память.
Описание
Это может быть что угодно.
Веб-сайт
Полный URL-адрес вашего веб-сайта (например, http://www.yourwebsite.com).
URI обратного вызова
Для этого параметра требуется очень конкретный URL-адрес для идентификации вашего приложения. URL-адрес, который необходимо вставить сюда, — это URL-адрес, ведущий непосредственно на вкладку Social Follow Networks в настройках Monarch на панели инструментов WordPress. Чтобы получить этот URL-адрес, войдите в свою панель инструментов WordPress и нажмите 9.0184 Инструменты> Настройки Monarch> Социальные сети> Сети , а затем скопируйте и вставьте URL-адрес из адресной строки. Это будет выглядеть примерно так:
http://www.yourwebsite.com/wp-admin/tools.php
После того, как вы введете необходимую информацию, нажмите кнопку «Создать приложение Twitter», и вы попадете на новую страницу, содержащую информацию, необходимую для привязки Monarch к вашей учетной записи. Скопируйте и вставьте Consumer Key, Consumer Secret, Access Token и Access Token Secret в настройки Twitter API на вкладке «Сети» панели настроек Monarch. Нажмите кнопку «Авторизовать», чтобы завершить процесс. Monarch теперь будет автоматически собирать количество ваших подписчиков в Твиттере.
Ютуб
Youtube использует ключи авторизации для своего API, а это означает, что требуется несколько дополнительных шагов аутентификации, прежде чем Monarch сможет получить доступ к количеству ваших подписчиков. Сначала введите идентификатор вашего канала в поле «имя» на вкладке сетей Monarch. Идентификатор канала можно найти в конце URL-адреса вашего канала. Например:
https://www.youtube.com/channel/ UCuasRuWliU48RwnKXf9GesA
Получить ключ API
Теперь войдите в свою учетную запись Youtube, а затем войдите в консоль разработчиков Google, где вы создадите новый проект . Затем на боковой панели слева нажмите Обзор . В списке API убедитесь, что YouTube Data API v3 включен в список Включенных API .
На боковой панели слева выберите Учетные данные . Нажмите синюю кнопку Создать учетные данные и выберите API-ключ 9. 0185 . В качестве типа ключа выберите Серверный ключ , а затем назначьте ему имя, чтобы его можно было запомнить. Наконец, выберите синюю кнопку Create . Теперь вы увидите свой новый ключ API. Вы должны скопировать и вставить ключ API в поля аутентификации Youtube на вкладке Social Follow панели управления Monarch. Когда вы нажимаете кнопку «Авторизовать», Monarch автоматически захватывает вашу долю на Youtube и количество подписчиков.
Пинтерест
Pinterest упрощает доступ к API для вашей учетной записи. Просто введите URL-адрес страницы своего профиля Pinterest в поле URL-адрес Pinterest на вкладке «Сети» панели настроек Monarch. Монарх теперь будет автоматически собирать количество ваших подписчиков.
Фейсбук
Facebook использует OAuth для своего API, а это означает, что требуется несколько дополнительных шагов аутентификации, прежде чем он позволит Monarch получить доступ к обмену информацией и подписке. Чтобы начать процесс, откройте панель управления Monarch и перейдите на вкладку «Социальные сети». Если вы еще этого не сделали, включите Facebook, нажав Добавить сети . Теперь вы увидите четыре поля ввода. Во втором поле (слева) введите полный URL-адрес своей страницы Facebook. В третье поле введите только данные вашей Страницы Facebook имя . Дополнительную информацию о том, как настроить имя для своей Страницы Facebook, см. в этой статье Справочного центра Facebook.
URL-адреса страниц обычно имеют следующий формат: http://facebook.com/your-page-name
Чтобы получить идентификатор приложения и секрет для Monarch, войдите в свою учетную запись Facebook, а затем перейдите на страницу разработчиков
Facebook. В главном меню наведите курсор на «Мои приложения» и нажмите «Добавить новое приложение».
Теперь введите имя для вашего приложения. Это может быть что угодно. Просто есть что вспомнить. Затем при необходимости измените контактный адрес электронной почты и нажмите 9.0184 Создать идентификатор приложения.
На следующем шаге вам будет предложено «Выбрать сценарий», где вы можете выбрать первый вариант «Интегрировать вход через Facebook». Нажмите «Подтвердить», чтобы подтвердить выбор.
Теперь в главном меню слева найдите раздел Продукты и нажмите Вход через Facebook > Настройки .
Найдите поле с пометкой Действительные URI перенаправления OAuth и введите URL-адрес перенаправления вашего сайта в следующем формате (замените выделенную часть своим доменом):
https://your-website.com/wp-admin/tools.php?page=et_monarch_options#tab_et_social_tab_content_general_main
Теперь нажмите кнопку с надписью Сохранить изменения , расположенную в правом нижнем углу страницы.
Примечание. По состоянию на март 2018 года во всех новых приложениях параметр «Принудительно использовать HTTPS» включен по умолчанию, и его нельзя отключить. Дополнительную информацию об этом можно найти здесь.
Наконец, вы должны скопировать и вставить App ID и App Secret в поля аутентификации Facebook на вкладке «Общие настройки» панели управления Monarch. Вы можете найти идентификатор и секрет в Настройки > Основные в меню слева.
Оставьте эту вкладку открытой и перейдите на панель инструментов WordPress > Инструменты > Настройки Monarch > Общие настройки и введите Идентификатор приложения и Секрет приложения из приложения Facebook.
После того, как вы нажмете на Авторизация вы будете перенаправлены на страницу авторизации Facebook, где вы можете увидеть всплывающее окно с предупреждающим сообщением, в котором говорится: «Некоторые из указанных ниже разрешений не были одобрены для использования Facebook. Отправьте на рассмотрение сейчас или узнайте больше». Это предупреждающее сообщение можно игнорировать, если учетная запись, которую вы используете для авторизации, является администратором как в приложении, так и на странице Facebook. Нажмите « Продолжить как… », затем « Хорошо, », чтобы завершить авторизацию, и теперь Monarch автоматически захватит вашу акцию в Facebook и количество подписчиков.
Инстаграм
Instragram использует OAuth для своего API, а это означает, что требуется несколько дополнительных шагов аутентификации, прежде чем Monarch сможет получить доступ к информации вашего профиля. Чтобы начать процесс, сначала войдите в менеджер клиентов разработчиков. После того, как вы нажмете URL-адрес, вам будет предложено войти в систему, чтобы получить доступ к инструментам API.
После входа в систему нажмите кнопку «Зарегистрировать приложение», чтобы начать. Затем нажмите кнопку «Зарегистрировать нового клиента» в верхней части экрана. На этом экране вам нужно будет заполнить следующие поля:
Имя приложения
Это может быть что угодно. Просто что-то на память.
Описание
Это может быть что угодно.
Веб-сайт
Введите полный URL-адрес вашего веб-сайта (например, http://www. yourwebsite.com).
URI перенаправления OAth
Для этого параметра требуется очень конкретный URL-адрес для идентификации вашего приложения. URL-адрес, который необходимо вставить сюда, — это URL-адрес, ведущий непосредственно на вкладку «Социальные сети» в настройках Monarch на панели инструментов WordPress. Чтобы получить этот URL-адрес, войдите в свою панель инструментов WordPress и нажмите 9.0184 Инструменты> Настройки Monarch> Социальные сети> Сети , а затем скопируйте и вставьте URL-адрес из адресной строки. Это будет выглядеть примерно так: http://www.yourwebsite.com/wp-admin/tools.php?page=et_monarch_options#tab_et_social_tab_content_follow_networks
После заполнения этих полей нажмите кнопку «Зарегистрироваться», чтобы завершить процесс. Вы попадете на новую страницу, на которой указана информация о вашем новом приложении. Вам нужно будет скопировать и вставить идентификатор клиента и секрет клиента в поля настроек Twitter API на вкладке Monarch Social Follow Networks, а затем нажать кнопку «Авторизовать», чтобы завершить процесс. После авторизации ваш веб-сайт автоматически получит количество подписчиков в социальных сетях.
LinkedIn использует OAuth для своего API, а это означает, что требуется несколько дополнительных шагов аутентификации, прежде чем Monarch сможет получить доступ к информации вашего профиля компании . Чтобы начать процесс, сначала получите доступ к безопасным инструментам разработчика. После того, как вы нажмете URL-адрес, вам будет предложено войти в систему, чтобы получить доступ к инструментам API.
После входа в систему нажмите кнопку «Добавить новое приложение», чтобы начать работу. Вы попадете на новую страницу, где вам нужно будет заполнить следующие поля, как показано здесь:
Имя приложения
Это может быть что угодно.
Описание
Это может быть что угодно.
URL-адрес веб-сайта
Введите полный URL-адрес вашего веб-сайта (например, http://www.yourwebsite.com).
Живой статус
Установите значение «Жить».
Область действия по умолчанию
r_basicprofile (выбрано только это)
URL-адрес перенаправления OAuth 2.0
Для этого параметра требуется очень конкретный URL-адрес для идентификации вашего приложения. URL-адрес, который необходимо вставить сюда, — это URL-адрес, ведущий непосредственно на вкладку «Социальные сети» в настройках Monarch на панели инструментов WordPress. Чтобы получить этот URL-адрес, войдите в свою панель инструментов WordPress и нажмите 9.0184 Инструменты> Настройки Monarch> Социальные сети> Сети , а затем скопируйте и вставьте URL-адрес из адресной строки. Затем удалите все после символа # в URL-адресе (http://www.yourwebsite.com/wp-admin/tools.php?page=et_monarch_options#tab_et_social_tab_content_follow_networks). В итоге это будет выглядеть примерно так: http://www.yourwebsite.com/wp-admin/tools.php?page=et_monarch_options
OAuth 1.0 Принять URL-адрес перенаправления
Введите тот же URL, что и в поле выше.
Затем нажмите кнопку «Добавить приложение», чтобы завершить процесс. Это приведет вас к странице успеха с некоторой информацией, которую вам нужно будет ввести в поля API LinkedIn на вкладке «Сети» на странице настроек Monarch в вашей панели управления WordPress. Скопируйте и вставьте ключ API и секретный ключ в необходимые поля, а затем нажмите кнопку «Авторизовать», чтобы завершить подтверждение. Monarch теперь сможет автоматически получать подписчиков вашей компании из LinkedIn.
Дрибббл
Прежде чем Dribbble предоставит Monarch количество ваших подписчиков, вам сначала необходимо зарегистрировать приложение и получить токен доступа. Сначала войдите на Dribbble.com, а затем перейдите на страницу регистрации приложения. Здесь вам нужно будет заполнить следующие поля:
Имя
Это может быть что угодно.
Описание
Это может быть что угодно.
URL-адрес веб-сайта
Введите полный URL-адрес вашего веб-сайта (например, http://www. yourwebsite.com).
URL обратного вызова
Введите полный URL-адрес вашего веб-сайта (например, http://www.yourwebsite.com).
Далее нажмите кнопку «Зарегистрировать приложение». Вы попадете на новую страницу с тремя частями информации. Скопируйте и вставьте «Токен доступа» в поле «Токен доступа Dribbble» на вкладке «Сети» на странице настроек Monarch. Монарх теперь будет автоматически собирать количество ваших подписчиков.
Vimeo
Vimeo использует OAuth для своего API, а это означает, что требуется несколько дополнительных шагов аутентификации, прежде чем Monarch сможет получить доступ к информации вашего профиля. Чтобы начать процесс, войдите в свою учетную запись, а затем получите доступ к инструментам API Vimeo, чтобы начать работу.
Нажмите кнопку «Создать новое приложение», а затем заполните необходимые поля, как показано ниже:
Имя приложения
Это может быть что угодно. Просто что-то на память.
Описание приложения
Это может быть что угодно.
URL-адрес приложения
Введите полный URL-адрес вашего веб-сайта (например, http://www.yourwebsite.com).
URI обратного вызова
Для этого параметра требуется очень конкретный URL-адрес для идентификации вашего приложения. URL-адрес, который необходимо вставить сюда, — это URL-адрес, ведущий непосредственно на вкладку «Социальные сети» в настройках Monarch на панели инструментов WordPress. Чтобы получить этот URL-адрес, войдите в свою панель инструментов WordPress и нажмите 9.0184 Инструменты> Настройки Monarch> Социальные сети> Сети , а затем скопируйте и вставьте URL-адрес из адресной строки. Это будет выглядеть примерно так: http://www.yourwebsite.com/wp-admin/tools.php?page=et_monarch_options#tab_et_social_tab_content_follow_networks
Нажмите кнопку «Создать приложение», чтобы вернуться на домашнюю страницу инструментов разработчика. Затем перейдите на вкладку «Аутентификация», которая предоставит вам список информации о вашем новом приложении. Вам нужно будет скопировать и вставить идентификатор клиента и секрет клиента в поля аутентификации Vimeo на вкладке «Сеть» панели настроек Monarch. Как только вы нажмете кнопку «Авторизовать», Monarch автоматически подберет количество ваших подписчиков Vimeo.
Саундклауд
Soundcloud требует две части информации, чтобы получить количество ваших подписчиков через их API: имя и идентификатор клиента. Чтобы получить доступ к этим данным, вам сначала необходимо зарегистрировать приложение в своей учетной записи Soundcloud.
Войдите в свою учетную запись Soundcloud.com, а затем перейдите на страницу приложений Soundcloud, чтобы начать работу. Нажмите кнопку «Зарегистрировать новое приложение», чтобы начать процесс создания приложения.
Далее вам будет предложено заполнить следующую информацию:
Имя
Это может быть что угодно.
Веб-сайт вашего приложения
Введите полный URL-адрес вашего веб-сайта, например: http://www. yourwebsite.com
URL-адрес перенаправления
Для этого параметра требуется очень конкретный URL-адрес для идентификации вашего приложения. URL-адрес, который необходимо вставить сюда, — это URL-адрес, ведущий непосредственно на вкладку «Социальные сети» в настройках Monarch на панели инструментов WordPress. Чтобы получить этот URL-адрес, войдите в свою панель инструментов WordPress и нажмите 9.0184 Инструменты> Настройки Monarch> Социальные сети> Сети , а затем скопируйте и вставьте URL-адрес из адресной строки. Это будет выглядеть примерно так: http://www.yourwebsite.com/wp-admin/tools.php?page=et_monarch_options#tab_et_social_tab_content_follow_networks
Нажмите кнопку «Сохранить приложение». После того, как ваше приложение будет сохранено, скопируйте и вставьте «Идентификатор клиента» (который будет указан на странице приложения, на которой вы сейчас находитесь) и ваше имя пользователя SoundCloud в настройки API SoundCloud на вкладке «Сети» панели настроек Monarch.