Инструменты для захвата и конвертирования Интернета

GrabzIt Клиент с PythonPython API

Описание

Этот класс обрабатывает все коммуникации с веб-сервисами GrabzIt.

Публичные методы

GetResult(Я бы)

Этот метод возвращает сам скриншот. Если ничего не возвращено, значит что-то пошло не так или скриншот еще не готов.

параметры

  • id - уникальный идентификатор скриншота
    • необходимые

Возвращаемое значение

Захват


URLToAnimation(URL, опционы = Нет)

Укажите URL-адрес онлайн-видео, которое необходимо преобразовать intанимированный GIF.

параметры

  • url - URL видео онлайн для конвертации intо анимированный GIF.
    • необходимые
    • Принимает Vimeo и YouTube видео URL
      • Предупреждение о анимации видео Vimeo и YouTube зависит от третьей стороны и, следовательно, может не дать согласованных результатов
  • опционы - экземпляр GrabzItAnimationOptions Класс, который определяет любые специальные параметры, которые будут использоваться при создании анимированного GIF.

Возвращаемое значение

аннулировать

GrabzItAnimationOptions

Класс представляет все параметры, доступные при создании анимированного GIF.

Атрибуты

  • customId - пользовательский идентификатор, который вы можете передать через анимированный GIF веб-сервис. Это будет возвращено с URL-адресом обратного вызова, который вы указали.
    • По умолчанию: пусто
  • width - ширина получаемого анимированного GIF в пикселях.
    • По умолчанию: 180px
    • Максимум: максимальная ширина для упаковки
    • Авто-размер: -1 (передача -1 означает, что ширина анимированный GIF масштабируется по отношению к его высоте, если ширина автоматически измеряется, высота не может)
  • height - высота получаемого анимированного GIF в пикселях.
    • По умолчанию: 120px
    • Максимум: максимальная высота упаковки
    • Авто-размер: -1 (передача -1 означает, что высота анимированный GIF масштабируется по отношению к его ширине, если высота автоматически измеряется, ширина не может)
  • start - начальная позиция видео, которое должно быть преобразовано intанимированный GIF.
    • По умолчанию: секунды 0
  • duration - продолжительность видео в секундах, которое должно быть конвертировано intанимированный GIF.
    • По умолчанию: максимальная длина пакета
  • speed - скорость анимированного GIF.
    • По умолчанию: 1
    • Минимум: 0.2
    • Максимум: 10
  • framesPerSecond - количество кадров в секунду, которое должно быть снято с видео.
    • По умолчанию: 10
    • Минимум: 0.2
    • Максимум: 60
  • repeat - количество циклов анимированного GIF.
    • По умолчанию: 0
    • Цикл непрерывно: 0
  • reverse - если true, кадры анимированного GIF меняются местами
    • По умолчанию: false
  • customWaterMarkId - добавить собственный водяной знак в анимированный GIF
    • По умолчанию: пусто
  • quality - качество возвращаемого изображения, который имеет сжатие по умолчанию 85%.
    • Снижение качества уменьшит размер файла и сократит время загрузки.
    • По умолчанию: -1
    • Минимум: -1
    • Максимум: 100
  • country - страна анимированный GIF должен быть взят из.
    • Предупреждение: эта функция в настоящее время находится в стадии бета-тестирования и может не давать согласованных результатов.
    • По умолчанию: текущее самое быстрое местоположение
    • Варианты: «SG», «UK», «US»
  • exportURL - URL экспорта это указывает, куда захват должен быть экспортирован тоже
    • По умолчанию: пусто
  • encryptionKey - если указан базовый ключ шифрования AES в кодировке 64, ваш захват шифруется при его создании. Рекомендуется использовать создать метод ключа шифрования создать ключ и методы дешифрования расшифровать зашифрованный захват, как показано в этот пример.
    • По умолчанию: пусто
  • proxy - подробности HTTP прокси программное обеспечение браузера должно использовать для создания этого захвата
    • По умолчанию: пусто

URLToImage(URL, опционы = Нет)

Определяет URL, который должен быть преобразован intскриншот изображения.

параметры

  • url - URL, из которого должен быть сделан снимок экрана
    • необходимые
  • опционы - экземпляр GrabzItImageOptions класс, который определяет любые специальные опции, которые будут использоваться при создании скриншота.

Возвращаемое значение

аннулировать

HTMLToImage(HTML, опционы = Нет)

Определяет HTML, который должен быть преобразован intoa изображение.

параметры

  • HTML - HTML для преобразования intизображение
    • необходимые
  • опционы - экземпляр GrabzItImageOptions Класс, который определяет любые специальные параметры, которые будут использоваться при создании изображения.

Возвращаемое значение

аннулировать

FileToImage(дорожка, опционы = Нет)

Определяет файл HTML, который должен быть преобразован intoa изображение.

параметры

  • путь - путь к файлу HTML-файла для преобразования intизображение
    • необходимые
  • опционы - экземпляр GrabzItImageOptions Класс, который определяет любые специальные параметры, которые будут использоваться при создании изображения.

Возвращаемое значение

аннулировать

GrabzItImageOptions

Класс представляет все параметры, доступные при создании снимков изображения.

Атрибуты

  • customId - пользовательский идентификатор, который вы можете передать на веб-сервис скриншотов. Он будет возвращен с указанным вами обратным URL-адресом.
    • По умолчанию: пусто
  • browserWidth - ширина браузера в пикселях
    • По умолчанию: 1024
    • Максимум: 10000
  • browserHeight - высота браузера в пикселях
    • По умолчанию: 768
    • Максимум: 10000
    • Полная длина: -1 (пропуск -1 означает, что взят снимок всей веб-страницы)
  • width - ширина получаемого эскиза в пикселях
    • По умолчанию: максимально возможное соотношение ширины браузера, которое соответствует максимальной ширине для пакета пользователя
    • Максимум: максимальная ширина для упаковки
    • Полная ширина: -1 (пропуск -1 означает, что ширина эскиза не уменьшается)
  • height - высота получаемого миниатюры в пикселях
    • По умолчанию: максимально возможное соотношение высоты браузера, которое соответствует максимальной высоте для пакета пользователя
    • Максимум: максимальная высота упаковки
    • Полная высота: -1 (пропуск -1 означает, что высота эскиза не уменьшается)
  • format - формат скриншота должен быть в.
    • По умолчанию: "JPG"
    • Опции: "bmp8", "bmp16", "bmp24", "bmp", "tiff", "webp", "jpg", "png"
  • delay - количество миллисекунд до подождите, прежде чем сделать скриншот
    • По умолчанию: 0
    • Максимум: 30000
  • targetElement - идентификатор или класс CSS селектор единственного HTML-элемента на целевой веб-странице, который должен быть повернут into Скриншот, все остальные части веб-страницы игнорируются. Если есть несколько совпадающих элементов HTML, выбирается первый
    • По умолчанию: пусто
  • hideElement - идентификатор или класс CSS селекторы один или несколько элементов HTML на веб-странице, которые нужно скрыть, чтобы указать несколько элементов HTML для скрытия, разделяя каждый селектор запятой
    • По умолчанию: пусто
  • waitForElement - идентификатор или класс CSS селекторы элемента HTML на веб-странице, которая должен быть виден до выполнения захвата
    • По умолчанию: пусто
  • requestAs - тип пользовательского агента, который вы хотите использовать
    • По умолчанию: 0
    • Опции:
      • 0 = указывает, что должен использоваться пользовательский агент стандартного браузера
      • 1 = указывает, что должен использоваться пользовательский агент мобильного браузера
      • 2 = указывает, что должен использоваться пользовательский агент поисковой системы
      • 3 = указывает, что должен использоваться пользовательский агент основного браузера
  • customWaterMarkId - добавить собственный водяной знак на изображение
    • По умолчанию: пусто
  • quality - качество возвращаемого изображения, В настоящее время это влияет только на изображения JPG, сжатие по умолчанию которых составляет 85%.
    • Снижение качества уменьшит размер файла и сократит время загрузки.
    • По умолчанию: -1
    • Минимум: -1
    • Максимум: 100
  • transparent - если правда захват изображения должен быть прозрачным, Это совместимо только с изображениями PNG и TIFF.
    • По умолчанию: false
  • hd - если верно изображение захват будет в высоком разрешении это удваивает размер изображения.
    • По умолчанию: false
  • country - страна скриншот должен быть взят из.
    • Предупреждение: эта функция в настоящее время находится в стадии бета-тестирования и может не давать согласованных результатов.
    • По умолчанию: текущее самое быстрое местоположение
    • Варианты: «SG», «UK», «US»
  • exportURL - URL экспорта это указывает, куда захват должен быть экспортирован тоже
    • По умолчанию: пусто
  • encryptionKey - если указан базовый ключ шифрования AES в кодировке 64, ваш захват шифруется при его создании. Рекомендуется использовать создать метод ключа шифрования создать ключ и методы дешифрования расшифровать зашифрованный захват, как показано в этот пример.
    • По умолчанию: пусто
  • noAds - если правда реклама должна быть автоматически скрыта.
    • По умолчанию: false
  • noCookieNotifications - если правда, все обычно встречаются уведомления о файлах cookie должны быть автоматически скрыты.
    • По умолчанию: false
  • address - URL для выполнения кода HTML. Может быть полезен, если конвертируемый HTML использует относительные URL для таких ресурсов, как CSS и изображения.
    • По умолчанию: пусто
  • proxy - подробности HTTP прокси программное обеспечение браузера должно использовать для создания этого захвата
    • По умолчанию: пусто

методы

  • AddPostParameter (имя, значение) - определяет параметр HTTP Post и, необязательно, значение; этот метод может вызываться несколько раз для добавления нескольких параметров. Использование этого метода заставит GrabzIt выполнить сообщение HTTP.
    • name - имя параметра HTTP Post
    • value - значение параметра HTTP Post

URLToRenderedHTML(URL, опционы = Нет)

Определяет URL, который должен быть преобразован intо рендеринга HTML.

параметры

  • url - URL-адрес, из которого должен быть выполнен визуализированный HTML
    • необходимые
  • опционы - экземпляр GrabzItHTMLOptions Класс, который определяет любые специальные опции, которые будут использоваться при создании визуализированного HTML.

Возвращаемое значение

аннулировать

HTMLToRenderedHTML(HTML, опционы = Нет)

Определяет HTML, который должен быть преобразован intо рендеринга HTML.

параметры

  • HTML - HTML для преобразования intо рендеринг HTML
    • необходимые
  • опционы - экземпляр GrabzItHTMLOptions Класс, который определяет любые специальные опции, которые будут использоваться при создании визуализированного HTML.

Возвращаемое значение

аннулировать

FileToRenderedHTML(дорожка, опционы = Нет)

Определяет файл HTML, который должен быть преобразован intо рендеринга HTML.

параметры

  • путь - путь к файлу HTML-файла для преобразования intо рендеринг HTML
    • необходимые
  • опционы - экземпляр GrabzItHTMLOptions Класс, который определяет любые специальные опции, которые будут использоваться при создании визуализированного HTML.

Возвращаемое значение

аннулировать

GrabzItHTMLOptions

Класс представляет все параметры, доступные при создание визуализированных захватов HTML.

Атрибуты

  • customId - пользовательский идентификатор, который вы можете передать через веб-сервис. Это будет возвращено с URL-адресом обратного вызова, который вы указали.
    • По умолчанию: пусто
  • browserWidth - ширина браузера в пикселях
    • По умолчанию: 1024
    • Максимум: 10000
  • browserHeight - высота браузера в пикселях
    • По умолчанию: 768
    • Максимум: 10000
  • waitForElement - идентификатор или класс CSS селекторы элемента HTML на веб-странице, которая должен быть виден до выполнения захвата
    • По умолчанию: пусто
  • requestAs - тип пользовательского агента, который вы хотите использовать
    • По умолчанию: 0
    • Опции:
      • 0 = указывает, что должен использоваться пользовательский агент стандартного браузера
      • 1 = указывает, что должен использоваться пользовательский агент мобильного браузера
      • 2 = указывает, что должен использоваться пользовательский агент поисковой системы
      • 3 = указывает, что должен использоваться пользовательский агент основного браузера
  • country - страна скриншот должен быть взят из.
    • Предупреждение: эта функция в настоящее время находится в стадии бета-тестирования и может не давать согласованных результатов.
    • По умолчанию: текущее самое быстрое местоположение
    • Варианты: «SG», «UK», «US»
  • exportURL - URL экспорта это указывает, куда захват должен быть экспортирован тоже
    • По умолчанию: пусто
  • encryptionKey - если указан базовый ключ шифрования AES в кодировке 64, ваш захват шифруется при его создании. Рекомендуется использовать создать метод ключа шифрования создать ключ и методы дешифрования расшифровать зашифрованный захват, как показано в этот пример.
    • По умолчанию: пусто
  • noAds - если правда реклама должна быть автоматически скрыта.
    • По умолчанию: false
  • noCookieNotifications - если правда, все обычно встречаются уведомления о файлах cookie должны быть автоматически скрыты.
    • По умолчанию: false
  • address - URL для выполнения кода HTML. Может быть полезен, если конвертируемый HTML использует относительные URL для таких ресурсов, как CSS и изображения.
    • По умолчанию: пусто
  • proxy - подробности HTTP прокси программное обеспечение браузера должно использовать для создания этого захвата
    • По умолчанию: пусто

методы

  • AddPostParameter (имя, значение) - определяет параметр HTTP Post и, необязательно, значение; этот метод может вызываться несколько раз для добавления нескольких параметров. Использование этого метода заставит GrabzIt выполнить сообщение HTTP.
    • name - имя параметра HTTP Post
    • value - значение параметра HTTP Post

URLToPDF(URL, опционы = Нет)

Определяет URL, который должен быть преобразован intoa PDF.

параметры

  • URL - URL, который должен быть преобразован intoa PDF
    • необходимые
  • опционы - экземпляр класса GrabzItPDFOptions, который определяет любые специальные параметры, используемые при создании PDF.

Возвращаемое значение

аннулировать

HTMLToPDF(HTML, опционы = Нет)

Определяет HTML, который должен быть преобразован intoa PDF.

параметры

  • HTML - HTML для преобразования intoa PDF
    • необходимые
  • опционы - экземпляр класса GrabzItPDFOptions, который определяет любые специальные параметры, используемые при создании PDF.

Возвращаемое значение

аннулировать

FileToPDF(дорожка, опционы = Нет)

Определяет файл HTML, который должен быть преобразован intoa PDF.

параметры

  • путь - путь к файлу HTML-файла для преобразования intoa PDF
    • необходимые
  • опционы - экземпляр класса GrabzItPDFOptions, который определяет любые специальные параметры, используемые при создании PDF.

Возвращаемое значение

аннулировать

GrabzItPDFOptions

Класс представляет все параметры, доступные при создании снимков PDF.

Атрибуты

  • customId - пользовательский идентификатор, который вы можете передать через веб-сервис. Это будет возвращено с URL-адресом обратного вызова, который вы указали.
    • По умолчанию: пусто
  • includeBackground - если true, фон веб-страницы должен быть включен в скриншот
    • По умолчанию: правда
  • pagesize - размер страницы PDF
    • По умолчанию: "A4"
    • Опции: "A3", "A4", "A5", "A6", "B3", "B4", "B5", "B6", "Legal", "Letter"
  • orientation - ориентация PDF документа
    • По умолчанию: «Портрет»
    • Опции: «Портрет», «Пейзаж»
  • cssMediaType - CSS Media Тип документа PDF
    • По умолчанию: «Экран»
    • Опции: «Экран», «Прint"
  • includeLinks - true, если ссылки должны быть включены в PDF
    • По умолчанию: правда
  • includeOutline - правда, если PDF закладки должны быть включены
    • По умолчанию: false
  • title - укажите название документа PDF
    • По умолчанию: пусто
  • coverURL - URL веб-страницы, которая должна использоваться в качестве обложки для PDF
    • По умолчанию: пусто
  • marginTop - поле в миллиметрах, которое должно отображаться в верхней части страницы документа PDF
    • По умолчанию: 10
  • marginLeft - поле в миллиметрах, которое должно появиться слева от страницы документа PDF
    • По умолчанию: 10
  • marginBottom - поле в миллиметрах, которое должно отображаться внизу страницы документа PDF
    • По умолчанию: 10
  • marginRight - поле в миллиметрах, которое должно отображаться справа от документа PDF
    • По умолчанию: 10
  • browserWidth - ширина браузера в пикселях
    • Предупреждение: эта функция в настоящее время находится в стадии бета-тестирования и может не давать согласованных результатов.
    • По умолчанию: 1024
    • Максимум: 10000
    • Авто Ширина: -1 (передача -1 означает, что ширина браузера соответствует ширине PDF-документа)
  • pageWidth - пользовательская ширина полученного PDF в мм
  • pageHeight - пользовательская высота получаемого PDF в мм
  • delay - количество миллисекунд до подождите, прежде чем сделать скриншот
    • По умолчанию: 0
    • Максимум: 30000
  • templateId - добавить шаблон Идентификатор, который определяет верхний и нижний колонтитулы документа PDF
    • По умолчанию: пусто
  • targetElement - идентификатор или класс CSS селектор единственного HTML-элемента на целевой веб-странице, который должен быть повернут intoa PDF, все остальные части веб-страницы игнорируются. Если есть несколько совпадающих элементов HTML, выбирается первый
    • По умолчанию: пусто
  • hideElement - идентификатор или класс CSS селекторы один или несколько элементов HTML на веб-странице, которые нужно скрыть, чтобы указать несколько элементов HTML для скрытия, разделяя каждый селектор запятой
    • По умолчанию: пусто
  • waitForElement - идентификатор или класс CSS селекторы элемента HTML на веб-странице, которая должен быть виден до выполнения захвата
    • По умолчанию: пусто
  • requestAs - тип пользовательского агента, который вы хотите использовать
    • По умолчанию: 0
    • Опции:
      • 0 = указывает, что должен использоваться пользовательский агент стандартного браузера
      • 1 = указывает, что должен использоваться пользовательский агент мобильного браузера
      • 2 = указывает, что должен использоваться пользовательский агент поисковой системы
      • 3 = указывает, что должен использоваться пользовательский агент основного браузера
  • customWaterMarkId - добавить собственный водяной знак на каждую страницу документа PDF
    • По умолчанию: пусто
  • quality - качество возвращаемого PDF, По умолчанию используется рекомендуемое качество для PDF.
    • Снижение качества уменьшит размер файла и сократит время загрузки.
    • По умолчанию: -1
    • Минимум: -1
    • Максимум: 100
  • country - страна скриншот должен быть взят из.
    • Предупреждение: эта функция в настоящее время находится в стадии бета-тестирования и может не давать согласованных результатов.
    • По умолчанию: текущее самое быстрое местоположение
    • Варианты: «SG», «UK», «US»
  • exportURL - URL экспорта это указывает, куда захват должен быть экспортирован тоже
    • По умолчанию: пусто
  • encryptionKey - если указан базовый ключ шифрования AES в кодировке 64, ваш захват шифруется при его создании. Рекомендуется использовать создать метод ключа шифрования создать ключ и методы дешифрования расшифровать зашифрованный захват, как показано в этот пример.
    • По умолчанию: пусто
  • noAds - если правда реклама должна быть автоматически скрыта.
    • По умолчанию: false
  • noCookieNotifications - если правда, все обычно встречаются уведомления о файлах cookie должны быть автоматически скрыты.
    • По умолчанию: false
  • address - URL для выполнения кода HTML. Может быть полезен, если конвертируемый HTML использует относительные URL для таких ресурсов, как CSS и изображения.
    • По умолчанию: пусто
  • proxy - подробности HTTP прокси программное обеспечение браузера должно использовать для создания этого захвата
    • По умолчанию: пусто
  • mergeId - идентификатор захвата, который должен быть объединены в начале нового документа PDF
    • По умолчанию: пусто
  • password - пароль для защиты PDF документа с
    • По умолчанию: пусто

методы

  • AddPostParameter (имя, значение) - определяет параметр HTTP Post и, необязательно, значение; этот метод может вызываться несколько раз для добавления нескольких параметров. Использование этого метода заставит GrabzIt выполнить сообщение HTTP.
    • name - имя параметра HTTP Post
    • value - значение параметра HTTP Post
  • AddTemplateParameter (имя, значение) - определить пользовательский шаблон параметр и значение, этот метод может быть вызван несколько раз, чтобы добавить несколько параметров.
    • name - имя параметра шаблона
    • value - значение параметра шаблона

URLToDOCX (URL, опционы = Нет)

Определяет URL, который должен быть преобразован intооо

параметры

  • URL - URL, который должен быть преобразован intoa DOCX
    • необходимые
  • опционы - экземпляр GrabzItDOCXOptions Класс, который определяет любые специальные опции, которые будут использоваться при создании DOCX.

Возвращаемое значение

аннулировать

HTMLToDOCX(HTML, опционы = Нет)

Определяет HTML, который должен быть преобразован intооо

параметры

  • HTML - HTML для преобразования intoa DOCX
    • необходимые
  • опционы - экземпляр GrabzItDOCXOptions Класс, который определяет любые специальные опции, которые будут использоваться при создании DOCX.

Возвращаемое значение

аннулировать

FileToDOCX(дорожка, опционы = Нет)

Определяет файл HTML, который должен быть преобразован intооо

параметры

  • путь - путь к файлу HTML-файла для преобразования intoa DOCX
    • необходимые
  • опционы - экземпляр GrabzItDOCXOptions Класс, который определяет любые специальные опции, которые будут использоваться при создании DOCX.

Возвращаемое значение

аннулировать

GrabzItDOCXOptions

Класс представляет все параметры, доступные при создании захватов DOCX.

Атрибуты

  • customId - пользовательский идентификатор, который вы можете передать через веб-сервис. Это будет возвращено с URL-адресом обратного вызова, который вы указали.
    • По умолчанию: пусто
  • includeBackground - если true, фоновые изображения веб-страницы должны быть включены в DOCX
    • По умолчанию: правда
  • pagesize - размер страницы DOCX
    • По умолчанию: "A4"
    • Опции: "A3", "A4", "A5", "A6", "B3", "B4", "B5", "B6", "Legal", "Letter"
  • orientation - ориентация документа DOCX
    • По умолчанию: «Портрет»
    • Опции: «Портрет», «Пейзаж»
  • includeLinks - true, если ссылки должны быть включены в DOCX
    • По умолчанию: правда
  • includeImages - если true, фоновые изображения веб-страницы должны быть включены в DOCX
    • По умолчанию: правда
  • title - предоставить заголовок документа DOCX
    • По умолчанию: пусто
  • marginTop - поле в миллиметрах, которое должно отображаться в верхней части страницы документа DOCX
    • По умолчанию: 10
  • marginLeft - поле в миллиметрах, которое должно появиться слева от страницы документа DOCX
    • По умолчанию: 10
  • marginBottom - поле в миллиметрах, которое должно отображаться внизу страницы документа DOCX
    • По умолчанию: 10
  • marginRight - поле в миллиметрах, которое должно отображаться справа от документа DOCX
    • По умолчанию: 10
  • browserWidth - ширина браузера в пикселях
    • Предупреждение: эта функция в настоящее время находится в стадии бета-тестирования и может не давать согласованных результатов.
    • По умолчанию: 1024
    • Максимум: 10000
    • Авто Ширина: -1 (передача -1 означает, что ширина браузера соответствует ширине документа DOCX)
  • pageWidth - пользовательская ширина результирующего DOCX в мм
  • pageHeight - Пользовательская высота результирующего DOCX в мм
  • delay - количество миллисекунд до подождите, прежде чем сделать скриншот
    • По умолчанию: 0
    • Максимум: 30000
  • templateId - добавить шаблон Идентификатор, который определяет верхний и нижний колонтитулы документа DOCX
    • По умолчанию: пусто
  • targetElement - идентификатор или класс CSS селектор единственного HTML-элемента на целевой веб-странице, который должен быть повернут into DOCX, все остальные части веб-страницы игнорируются. Если есть несколько совпадающих элементов HTML, выбирается первый
    • По умолчанию: пусто
  • hideElement - идентификатор или класс CSS селекторы один или несколько элементов HTML на веб-странице, которые нужно скрыть, чтобы указать несколько элементов HTML для скрытия, разделяя каждый селектор запятой
    • По умолчанию: пусто
  • waitForElement - идентификатор или класс CSS селекторы элемента HTML на веб-странице, которая должен быть виден до выполнения захвата
    • По умолчанию: пусто
  • requestAs - тип пользовательского агента, который вы хотите использовать
    • По умолчанию: 0
    • Опции:
      • 0 = указывает, что должен использоваться пользовательский агент стандартного браузера
      • 1 = указывает, что должен использоваться пользовательский агент мобильного браузера
      • 2 = указывает, что должен использоваться пользовательский агент поисковой системы
      • 3 = указывает, что должен использоваться пользовательский агент основного браузера
  • quality - качество возвращаемого DOCX, По умолчанию используется рекомендуемое качество для DOCX.
    • Снижение качества уменьшит размер файла и сократит время загрузки.
    • По умолчанию: -1
    • Минимум: -1
    • Максимум: 100
  • country - страна скриншот должен быть взят из.
    • Предупреждение: эта функция в настоящее время находится в стадии бета-тестирования и может не давать согласованных результатов.
    • По умолчанию: текущее самое быстрое местоположение
    • Варианты: «SG», «UK», «US»
  • exportURL - URL экспорта это указывает, куда захват должен быть экспортирован тоже
    • По умолчанию: пусто
  • encryptionKey - если указан базовый ключ шифрования AES в кодировке 64, ваш захват шифруется при его создании. Рекомендуется использовать создать метод ключа шифрования создать ключ и методы дешифрования расшифровать зашифрованный захват, как показано в этот пример.
    • По умолчанию: пусто
  • noAds - если правда реклама должна быть автоматически скрыта.
    • По умолчанию: false
  • noCookieNotifications - если правда, все обычно встречаются уведомления о файлах cookie должны быть автоматически скрыты.
    • По умолчанию: false
  • address - URL для выполнения кода HTML. Может быть полезен, если конвертируемый HTML использует относительные URL для таких ресурсов, как CSS и изображения.
    • По умолчанию: пусто
  • proxy - подробности HTTP прокси программное обеспечение браузера должно использовать для создания этого захвата
    • По умолчанию: пусто
  • mergeId - идентификатор захвата, который должен быть объединены в начале нового документа DOCX
    • По умолчанию: пусто
  • password - пароль для защиты документа DOCX с
    • По умолчанию: пусто

методы

  • AddPostParameter (имя, значение) - определяет параметр HTTP Post и, необязательно, значение; этот метод может вызываться несколько раз для добавления нескольких параметров. Использование этого метода заставит GrabzIt выполнить сообщение HTTP.
    • name - имя параметра HTTP Post
    • value - значение параметра HTTP Post
  • AddTemplateParameter (имя, значение) - определить пользовательский шаблон параметр и значение, этот метод может быть вызван несколько раз, чтобы добавить несколько параметров.
    • name - имя параметра шаблона
    • value - значение параметра шаблона

URLToTable(URL, опционы = Нет)

Определяет URL, из которого должны быть извлечены таблицы HTML.

параметры

  • url - URL для извлечения HTML-таблиц из
    • необходимые
  • опционы - экземпляр GrabzItTableOptions Класс, который определяет любые специальные параметры, которые будут использоваться при преобразовании таблицы HTML.

Возвращаемое значение

аннулировать

HTMLToTable (HTML, опционы = Нет)

Определяет HTML, из которого должны быть извлечены таблицы HTML.

параметры

  • html - HTML-код для извлечения HTML-таблиц.
    • необходимые
  • опционы - экземпляр GrabzItTableOptions Класс, который определяет любые специальные параметры, которые будут использоваться при преобразовании таблицы HTML.

Возвращаемое значение

аннулировать

FileToTable (путь, опционы = Нет)

Указывает файл HTML, из которого должны быть извлечены таблицы HTML.

параметры

  • путь - путь к файлу HTML, из которого извлекаются таблицы HTML.
    • необходимые
  • опционы - экземпляр GrabzItTableOptions Класс, который определяет любые специальные параметры, которые будут использоваться при преобразовании таблицы HTML.

Возвращаемое значение

аннулировать

GrabzItTableOptions

Класс представляет все параметры, доступные при преобразовании таблиц HTML в CSV, XLSX или JSON.

Атрибуты

  • customId - пользовательский идентификатор, который вы можете передать через веб-сервис. Это будет возвращено с URL-адресом обратного вызова, который вы указали
    • По умолчанию: пусто
  • tableNumberToInclude - индекс таблицы, которую нужно преобразовать, если все таблицы на веб-странице упорядочены сверху вниз по веб-странице
    • По умолчанию: 1
  • format - формат таблицы должен быть в
    • По умолчанию: "CSV"
    • Опции: "CSV", "JSON", "XLSX"
  • includeHeaderNames - если в таблицу будут включены истинные имена заголовков
    • По умолчанию: правда
  • includeAllTables - если true, вся таблица на веб-странице будет извлечена, и каждая таблица появится в отдельном листе электронной таблицы. Доступно только с форматом XLSX
    • По умолчанию: false
  • targetElement - идентификатор единственного HTML-элемента на веб-странице, который должен использоваться для извлечения таблиц из
    • По умолчанию: пусто
  • requestAs - тип пользовательского агента, который вы хотите использовать
    • По умолчанию: 0
    • Опции:
      • 0 = указывает, что должен использоваться пользовательский агент стандартного браузера
      • 1 = указывает, что должен использоваться пользовательский агент мобильного браузера
      • 2 = указывает, что должен использоваться пользовательский агент поисковой системы
      • 3 = указывает, что должен использоваться пользовательский агент основного браузера
  • country - страна скриншот должен быть взят из.
    • Предупреждение: эта функция в настоящее время находится в стадии бета-тестирования и может не давать согласованных результатов.
    • По умолчанию: текущее самое быстрое местоположение
    • Варианты: «SG», «UK», «US»
  • exportURL - URL экспорта это указывает, куда захват должен быть экспортирован тоже
    • По умолчанию: пусто
  • encryptionKey - если указан базовый ключ шифрования AES в кодировке 64, ваш захват шифруется при его создании. Рекомендуется использовать создать метод ключа шифрования создать ключ и методы дешифрования расшифровать зашифрованный захват, как показано в этот пример.
    • По умолчанию: пусто
  • address - URL для выполнения кода HTML. Может быть полезен, если конвертируемый HTML использует относительные URL для таких ресурсов, как CSS и изображения.
    • По умолчанию: пусто
  • proxy - подробности HTTP прокси программное обеспечение браузера должно использовать для создания этого захвата
    • По умолчанию: пусто

методы

  • AddPostParameter (имя, значение) - определяет параметр HTTP Post и, необязательно, значение; этот метод может вызываться несколько раз для добавления нескольких параметров. Использование этого метода заставит GrabzIt выполнить сообщение HTTP.
    • name - имя параметра HTTP Post
    • value - значение параметра HTTP Post

Это рекомендуемый метод сохранения файла

Save(callBackURL = '')

Save результат асинхронно и возвращает уникальный идентификатор, который можно использовать для получения снимка экрана с GetResult метод.

параметры

  • callBackURL - обработчик Служба GrabzIt должна позвонить после завершения своей работы

Возвращаемое значение

Уникальный идентификатор скриншота, в противном случае, если произошла ошибка, генерируется исключение. Это можно использовать для получения скриншота с GetResult метод


Предупреждение: этот метод является синхронным, поэтому приложение будет приостановлено во время обработки результата

SaveTo()

Save результат синхронно с переменной, содержащей данные байта снимка экрана.

Возвращаемое значение

в случае успеха возвращает байтовые данные файла, в противном случае выдается исключение.


Предупреждение: этот метод является синхронным, поэтому приложение будет приостановлено во время обработки результата

SaveTo(saveToFile)

Save результат синхронно в файл.

параметры

  • saveToFile - путь к файлу, захват которого будет saved, когда он будет завершен
    • необходимые

Возвращаемое значение

возвращает true, если он успешен, в противном случае выдается исключение.


GetStatus (ID)

Получить текущий статус скриншота GrabzIt.

параметры

  • id - уникальный идентификатор скриншота
    • необходимые

Возвращаемое значение

ScreenShotStatus объект


GetCookies (домен)

Получить все куки, которые GrabzIt использует для определенного домена. Это может также включать определенные пользователем файлы cookie.

параметры

  • домен - домен для возврата куки
    • необходимые

Возвращаемое значение

GrabzItCookie массив


SetCookie (имя, домен, значение = "", путь = "/", httponly = False, expires = "")

Устанавливает новый пользовательский файл cookie для GrabzIt, если пользовательский файл cookie имеет то же имя и домен, что и глобальный файл cookie, глобальный файл cookie переопределяется.

Это может быть полезно, если функциональность веб-сайта контролируется куки-файлами.

параметры

  • name - имя куки для установки
    • необходимые
  • домен - домен веб-сайта, для которого устанавливается файл cookie
    • необходимые
  • value - значение куки
  • путь - путь к сайту, к которому относится cookie
  • httponly - если true, cookie может использоваться только с протоколом HTTP
  • expires - определяет, когда истекает срок действия cookie. Передайте значение None, если срок действия файла cookie не истек
    • Должен быть в формате гггг-мм-дд чч: мм: сс

Возвращаемое значение

True, если cookie успешно установлен, иначе false


DeleteCookie (имя, домен)

Удалить пользовательский файл cookie или заблокировать использование глобального файла cookie

параметры

  • name - имя куки для удаления
    • необходимые
  • домен - домен сайта для удаления куки
    • необходимые

Возвращаемое значение

True, если cookie успешно удален, иначе false


ПолучитьWaterMarks()

Получите ваши загруженные пользовательские водяные знаки

Возвращаемое значение

GrabzItWaterMark массив


ПолучитьWaterMark(идентификатор)

Вернуть ваши пользовательские водяные знаки, которые соответствуют указанному идентификатору

параметры

  • идентификатор - идентификатор определенного пользовательского водяного знака, который вы хотите просмотреть
    • необходимые

Возвращаемое значение

GrabzItWaterMark


ДобавитьWaterMark(идентификатор, путь, xpos, ypos)

Добавить новый пользовательский водяной знак

параметры

  • идентификатор - идентификатор, который вы хотите присвоить пользовательскому водяному знаку. Важно, чтобы этот идентификатор был уникальным.
    • необходимые
  • путь - абсолютный путь водяного знака на вашем сервере. Например, C: /watermark/1.png
    • необходимые
  • xpos - горизонтальная позиция, в которой вы хотите, чтобы скриншот появлялся в
    • необходимые
    • Опции:
      • Слева = 0
      • Центр = 1
      • Право = 2
  • ypos - вертикальная позиция, в которой вы хотите, чтобы скриншот появлялся в
    • необходимые
    • Опции:
      • Top = 0
      • Средний = 1
      • Низ = 2

Возвращаемое значение

возвращает true, если водяной знак был успешно установлен


DeleteWaterMark(идентификатор)

Удалить пользовательский водяной знак

параметры

  • идентификатор - идентификатор пользовательского водяного знака, который вы хотите удалить
    • необходимые

Возвращаемое значение

возвращает true, если водяной знак был успешно удален


SetLocalProxy (proxyUrl)

Этот метод позволяет локальный прокси-сервер использоваться для всех запросов.

параметры

  • proxyUrl - URL-адрес, который может включать порт прокси-сервера при необходимости. Предоставление нулевого значения удалит любой ранее установленный прокси
    • необходимые

UseSSL (значение)

Определяет, если запросы к GrabzIt's API должен использовать SSL

параметры

  • значение - если true, все запросы к API GrabzIt будут использовать SSL
    • необходимые

CreateEncryptionKey ()

Создайте криптографически безопасный базовый ключ шифрования 64 длиной 44.


Расшифровать (данные, ключ)

Расшифруйте зашифрованный захват, используя предоставленный ключ шифрования.

параметры


DecryptFile (путь, ключ)

Расшифруйте зашифрованный захват, используя предоставленный ключ шифрования.

параметры

  • путь - путь зашифрованного захвата
    • необходимые
  • ключ - ключ шифрования
    • необходимые

Классы результатов

GrabzItCookie

Публичная недвижимость

  • Name
    • Название куки.
  • Value
    • Значение cookie.
  • Domain
    • Домен, для которого установлен файл cookie.
  • Path
    • Путь в домене, к которому применяется этот файл cookie.
  • HttpOnly
    • Если этот файл cookie действителен только при просмотре веб-сайта по протоколу HTTP.
  • Expires
    • Дата истечения срока действия этого cookie
  • Type
    • Тип cookie это может быть одним из следующих:
      • Global - это глобальный файл cookie, созданный GrabzIt
      • Local - это локальный файл cookie, установленный вами
      • Переопределено - глобальный файл cookie, который был переопределен вами

ScreenShotStatus

Класс, представляющий текущий статус скриншота.

Публичная недвижимость

  • Processing
    • Если это правда, скриншот все еще обрабатывается.
  • Cached
    • Если true, снимок экрана был обработан и в настоящее время кэширован.
  • Expired
    • Если это правда, скриншот больше не находится в системе GrabzIt.
  • Message
    • Сообщение об ошибке, возвращенное системой.

GrabzItWaterMark

Этот класс представляет пользовательские водяные знаки, хранящиеся в GrabzIt

Публичная недвижимость

  • Identifier
    • Идентификатор водяного знака
  • XPosition
    • Горизонтальное положение водяного знака
      • Слева = 0
      • Центр = 1
      • Право = 2
  • YPosition
    • Вертикальное положение водяного знака
      • Top = 0
      • Средний = 1
      • Низ = 2
  • Format
    • Формат водяного знака