- Регистрация
- 03.05.2016
- Сообщения
- 949
- Реакции
- 734
- Баллы
- 93
Всем привет, специально для данного конкурса подготовил небольшой, но очень полезный шаблон для автоматизации постинга статей на базе Телеграф.
Вот такие статьи мы будем получать: Статья.
Пример использования шаблона: Ссылка.
Telegra.ph - это уникальная платформа, предоставленная Telegram, которая позволяет пользователям создавать красиво оформленные статьи и публиковать их в сети без необходимости регистрации или создания отдельного аккаунта. Это простое и эффективное средство для создания и публикации контента прямо из мессенджера.
Основные особенности Telegra.ph:
- Простота использования: Платформа обладает интуитивно понятным интерфейсом, позволяющим быстро создавать и редактировать статьи. Отсутствие необходимости в регистрации делает процесс еще более удобным.
- Богатый функционал: Telegra.ph поддерживает различные элементы контента, такие как текст, изображения и видео. Пользователи могут легко оформить свои статьи с помощью доступных инструментов форматирования.
- Гибкость и универсальность: Публикации на Telegra.ph могут быть доступны по прямой ссылке, а также встроены в Telegram-каналы и группы.
- Открытость API: Telegra.ph предоставляет API для взаимодействия с платформой, что открывает широкие возможности для автоматизации создания и управления контентом.
Использование API Telegra.ph позволяет легко и просто автоматизировать публикацию контента и расширить функциональность мессенджера Telegram.
Дальше я расскажу подробнее, как запустить автопостинг для работы с контентом.
1. Создаем объект класса MyTelegraph.
2. Создаем аккаунт через метод CreateAccount() - получаем AccessToken для дальнейшей работы. (Можем его сохранить отдельно из свойства AccessToken, для дальнейшей работы без создания каждый раз нового аккаунта)
3. Если надо загрузить картинку на сервера Telegra.ph используем метод UploadImg() - получаем url для дальнейшего использования.
4. Через поле ContentBuilder - создаем блоки контента для нашей статьи.
C#:
var t = new Telegraf(project);
var creator = t.ContentBuilder;
var content = creator
.AddImg(imgUrl)
.AddText(text)
.AddText("")
.AddLink("https://zennolab.com/discussion/threads/posting-statej-na-avtomate-avtomatizacija-telegra-ph.118163", "Читать статью")
.Create();Для большего понимания прикрепил шаблон с примером. Так же можете ознакомиться с полным кодом в разделе "Общий Код".
Небольшая документация.
Для работы написан отдельный класс Telegraph, который представляет собой клиент для взаимодействия с API Telegra.ph.
Поля:
- ContentBuilder : экземпляр класса ContentBuilder для быстрого и удобного создания JSON структуры контента перед созданием страницы.
Свойства:
- ShortName: короткое имя созданного аккаунта Telegra.ph.
- AccessToken: токен доступа к API Telegra.ph.
Методы:
- MyTelegraph(IZennoPosterProjectModel project): конструктор класса, инициализирует экземпляр класса MyTelegraph.
Параметры:
- project: объект, представляющий проект в ZennoPoster.
- bool CreateAccount (string shortName, string authorName = "", string authorUrl = ""): создает аккаунт на Telegra.ph.
Параметры:
- shortName: короткое имя аккаунта.
- authorName: имя автора (по умолчанию пустое).
- authorUrl: ссылка на автора (по умолчанию пустая).
Возвращает:
- true, если аккаунт успешно создан.
Исключения:
- Exception: в случае ошибки при создании аккаунта.
- void SetAccessToken (string accessToken): устанавливает пользовательский AccessToken для доступа к API Telegra.ph.
Параметры:
- accessToken: пользовательский AccessToken.
- string CreatePage (string title, string content, string authorName = "", string authorUrl = "", bool isReturnContent = false): создает страницу на Telegra.ph.
Параметры:
- title: заголовок страницы.
- content: контент страницы в формате JSON.
- authorName: имя автора (по умолчанию пустое).
- authorUrl: ссылка на автора (по умолчанию пустая).
- isReturnContent: указывает, нужно ли возвращать содержимое контента в объекте страницы (по умолчанию false).
Возвращает:
- URL созданной страницы на Telegra.ph.
Исключения:
- Exception: в случае ошибки при создании страницы.
- string UploadImg (string pathImg): загружает изображение на Telegra.ph. (работает без accessToken)
Параметры:
- pathImg: путь к изображению.
Возвращает:
- URL загруженного изображения на Telegra.ph.
Исключения:
- Exception: в случае ошибки при загрузке изображения.
Вспомогательный класс ContentBuilder - представляет собой строитель JSON контента для размещения в Telegra.ph. Вызывается через поле ContentBuilder класса MyTelegraph
Методы:
- string Create(): создает и возвращает итоговый контент в формате JSON.
Возвращает:
- итоговый контент в формате JSON.
- ContentBuilder AddImg (string urlImg): добавляет изображение в контент.
Параметры:
- urlImg: URL изображения.
Возвращает:
- экземпляр класса ContentBuilder для поддержки цепочки вызовов (Fluent Interface).
- ContentBuilder AddText (string text): добавляет текстовый элемент в контент.
Параметры:
- text: текст для добавления.
Возвращает:
- экземпляр класса ContentBuilder для поддержки цепочки вызовов (Fluent Interface).
- ContentBuilder AddLink (string link, string name): добавляет ссылку в контент.
Параметры:
- link: URL ссылки.
- name: название ссылки.
Возвращает:
- экземпляр класса ContentBuilder для поддержки цепочки вызовов (Fluent Interface).
Поля:
- ContentBuilder : экземпляр класса ContentBuilder для быстрого и удобного создания JSON структуры контента перед созданием страницы.
Свойства:
- ShortName: короткое имя созданного аккаунта Telegra.ph.
- AccessToken: токен доступа к API Telegra.ph.
Методы:
- MyTelegraph(IZennoPosterProjectModel project): конструктор класса, инициализирует экземпляр класса MyTelegraph.
Параметры:
- project: объект, представляющий проект в ZennoPoster.
- bool CreateAccount (string shortName, string authorName = "", string authorUrl = ""): создает аккаунт на Telegra.ph.
Параметры:
- shortName: короткое имя аккаунта.
- authorName: имя автора (по умолчанию пустое).
- authorUrl: ссылка на автора (по умолчанию пустая).
Возвращает:
- true, если аккаунт успешно создан.
Исключения:
- Exception: в случае ошибки при создании аккаунта.
- void SetAccessToken (string accessToken): устанавливает пользовательский AccessToken для доступа к API Telegra.ph.
Параметры:
- accessToken: пользовательский AccessToken.
- string CreatePage (string title, string content, string authorName = "", string authorUrl = "", bool isReturnContent = false): создает страницу на Telegra.ph.
Параметры:
- title: заголовок страницы.
- content: контент страницы в формате JSON.
- authorName: имя автора (по умолчанию пустое).
- authorUrl: ссылка на автора (по умолчанию пустая).
- isReturnContent: указывает, нужно ли возвращать содержимое контента в объекте страницы (по умолчанию false).
Возвращает:
- URL созданной страницы на Telegra.ph.
Исключения:
- Exception: в случае ошибки при создании страницы.
- string UploadImg (string pathImg): загружает изображение на Telegra.ph. (работает без accessToken)
Параметры:
- pathImg: путь к изображению.
Возвращает:
- URL загруженного изображения на Telegra.ph.
Исключения:
- Exception: в случае ошибки при загрузке изображения.
Вспомогательный класс ContentBuilder - представляет собой строитель JSON контента для размещения в Telegra.ph. Вызывается через поле ContentBuilder класса MyTelegraph
Методы:
- string Create(): создает и возвращает итоговый контент в формате JSON.
Возвращает:
- итоговый контент в формате JSON.
- ContentBuilder AddImg (string urlImg): добавляет изображение в контент.
Параметры:
- urlImg: URL изображения.
Возвращает:
- экземпляр класса ContentBuilder для поддержки цепочки вызовов (Fluent Interface).
- ContentBuilder AddText (string text): добавляет текстовый элемент в контент.
Параметры:
- text: текст для добавления.
Возвращает:
- экземпляр класса ContentBuilder для поддержки цепочки вызовов (Fluent Interface).
- ContentBuilder AddLink (string link, string name): добавляет ссылку в контент.
Параметры:
- link: URL ссылки.
- name: название ссылки.
Возвращает:
- экземпляр класса ContentBuilder для поддержки цепочки вызовов (Fluent Interface).
Спасибо, что дочитали мою статьи. Надеюсь, что она, была полезной и интересной для вас. Если у вас возникли вопросы или предложения, Пишите в комментариях. Благодарю за внимание и желаю успехов в вашей работе!
#####################
Мой Телеграм Канал
Мой Youtube Канал
Поддержка автора: Донат
#####################
- Номер конкурса шаблонов
- Двенадцатый конкурс шаблонов
Последнее редактирование модератором:
