Narzędzia do przechwytywania i konwertowania Internetu

Klient GrabzIt z RubyRuby API

Opis

Ta klasa obsługuje całą komunikację z usługami zrzutów ekranu GrabzIt.

Metody publiczne

get_result (id)

Ta metoda zwraca sam zrzut ekranu. Jeśli nic nie zostanie zwrócone, oznacza to, że coś poszło nie tak lub zrzut ekranu nie jest jeszcze gotowy.

parametry

  • id - unikalny identyfikator zrzutu ekranu
    • wymagany

Wartość zwracana

Schwytanie


url_to_animation(url, Opcje = zero)

Określ adres URL wideo online, które należy przekonwertować into animowany GIF.

parametry

  • url - adres URL wideo online do konwersji into animowany GIF.
    • wymagany
    • Akceptuje adresy URL wideo Vimeo i YouTube
      • Ostrzeżenie dotyczące animowania filmów Vimeo i YouTube zależy od strony trzeciej, dlatego może nie zapewniać spójnych wyników.
  • Opcje - instancja AnimationOptions klasa, która definiuje wszelkie specjalne opcje do użycia podczas tworzenia animowanego GIF-a.

Wartość zwracana

unieważnić

AnimationOptions

Klasa reprezentuje wszystkie opcje dostępne podczas tworzenia animowanego GIF-a.

Właściwości publiczne

  • customId - niestandardowy identyfikator, który można przekazać do animowanej usługi internetowej GIF. Zostanie to zwrócone z podanym adresem URL wywołania zwrotnego.
    • Domyślnie: pusty
  • width - szerokość wynikowego animowanego GIF-a w pikselach.
    • Domyślnie: 180px
    • Maksymalna: maksymalna szerokość paczki
    • Rozmiar automatyczny: -1 (przekazanie -1 oznacza, że ​​szerokość animowany GIF jest skalowany w stosunku do jego wysokości, jeśli szerokość jest automatycznie dopasowywana, wysokość nie może)
  • height - wysokość powstałego animowanego GIF-a w pikselach.
    • Domyślnie: 120px
    • Maksymalna: maksymalna wysokość paczki
    • Rozmiar automatyczny: -1 (przekazanie -1 oznacza, że ​​wysokość animowany GIF jest skalowany w stosunku do szerokości, jeśli wysokość jest automatycznie dopasowywana, szerokość nie może)
  • start - początkowa pozycja filmu, który należy przekonwertować into animowany GIF.
    • Domyślnie: 0 sekund
  • duration - długość w sekundach filmu, który należy przekonwertować into animowany GIF.
    • Domyślnie: maksymalna długość paczki
  • speed - prędkość animowanego GIF-a.
    • Domyślnie: 1
    • Minimum: 0.2
    • Maksymalna ilość znaków: 10
  • framesPerSecond - liczba klatek na sekundę, które powinny zostać przechwycone z wideo.
    • Domyślnie: 10
    • Minimum: 0.2
    • Maksymalna ilość znaków: 60
  • repeat - ile razy zapętlono animowany GIF.
    • Domyślnie: 0
    • Pętla w sposób ciągły: 0
  • reverse - jeśli to prawda, ramki animowanego GIF-a są odwrócone
    • Domyślnie: false
  • customWaterMarkId - dodaj niestandardowy znak wodny do animowanego GIF-a
    • Domyślnie: pusty
  • quality - w jakość zwróconego obrazu, który ma domyślną kompresję 85%.
    • Zmniejszenie jakości zmniejszy rozmiar plików i skróci czas pobierania.
    • Domyślnie: -1
    • Minimum: -1
    • Maksymalna ilość znaków: 100
  • country - kraj animowany GIF powinien zostać pobrany.
    • Ostrzeżenie: ta funkcja jest obecnie w fazie beta i może nie zapewniać spójnych wyników.
    • Domyślnie: bieżąca najszybsza lokalizacja
    • Opcje: „SG”, „UK”, „US”
  • exportURL - w eksportuj adres URL określa, gdzie przechwytywanie powinno być również eksportowane
    • Domyślnie: pusty
  • encryptionKey - jeśli określono podstawowy klucz szyfrowania AES 64, twoje przechwytywanie jest szyfrowane podczas jego tworzenia. Zalecane jest użycie utwórz metodę klucza szyfrowania stworzyć klucz i metody deszyfrowania aby odszyfrować zaszyfrowane przechwycenie, jak pokazano w ten przykład.
    • Domyślnie: pusty
  • proxy - szczegóły proxy HTTP oprogramowanie przeglądarki powinno być użyte do utworzenia tego przechwytywania
    • Domyślnie: pusty

url_to_image(url, Opcje = zero)

Określa adres URL, który należy przekonwertować into zrzut ekranu obrazu.

parametry

  • url - adres URL, z którego należy wykonać zrzut ekranu
    • wymagany
  • Opcje - instancja ImageOptions klasa, która definiuje specjalne opcje do użycia podczas tworzenia zrzutu ekranu.

Wartość zwracana

unieważnić

html_to_image(html, Opcje = zero)

Określa kod HTML, który należy przekonwertować into obrazie.

parametry

  • HTML - kod HTML do konwersji into obrazie
    • wymagany
  • Opcje - instancja ImageOptions klasa, która definiuje wszelkie specjalne opcje do użycia podczas tworzenia obrazu.

Wartość zwracana

unieważnić

file_to_image(ścieżka, Opcje = zero)

Określa plik HTML, który należy przekonwertować into obrazie.

parametry

  • ścieżka - ścieżka pliku HTML do konwersji into obrazie
    • wymagany
  • Opcje - instancja ImageOptions klasa, która definiuje wszelkie specjalne opcje do użycia podczas tworzenia obrazu.

Wartość zwracana

unieważnić

ImageOptions

Klasa reprezentuje wszystkie opcje dostępne podczas tworzenia zrzutów obrazu.

Właściwości publiczne

  • customId - niestandardowy identyfikator, który można przekazać do usługi zrzutów ekranu. Zostanie to zwrócone z podanym adresem URL wywołania zwrotnego.
    • Domyślnie: pusty
  • browserWidth - szerokość przeglądarki w pikselach
    • Domyślnie: 1024
    • Maksymalna ilość znaków: 10000
  • browserHeight - wysokość przeglądarki w pikselach
    • Domyślnie: 768
    • Maksymalna ilość znaków: 10000
    • Pełna długość: -1 (przekazanie -1 oznacza, że ​​wykonano sceenshot całej strony)
  • width - szerokość wynikowej miniatury w pikselach
    • Domyślnie: najwyższy możliwy stosunek szerokości przeglądarki, który mieści się w maksymalnej szerokości pakietu użytkowników
    • Maksymalna: maksymalna szerokość paczki
    • Pełna szerokość: -1 (przekazanie -1 oznacza, że ​​szerokość miniatury nie jest zmniejszona)
  • height - wysokość powstałej miniatury w pikselach
    • Domyślnie: najwyższy możliwy stosunek wysokości przeglądarki, który mieści się w maksymalnej wysokości dla pakietu użytkowników
    • Maksymalna: maksymalna wysokość paczki
    • Pełna wysokość: -1 (przekazanie -1 oznacza, że ​​wysokość miniatury nie jest zmniejszona)
  • format - format, w jakim powinien być zrzut ekranu.
    • Domyślnie: „jpg”
    • Opcje: „bmp8”, „bmp16”, „bmp24”, „bmp”, „tiff”, „webp”, „jpg”, „png”
  • delay - liczba milisekund do poczekaj przed wykonaniem zrzutu ekranu
    • Domyślnie: 0
    • Maksymalna ilość znaków: 30000
  • targetElement - identyfikator lub klasa Selektor CSS jedynego elementu HTML na docelowej stronie internetowej, który ma zostać włączony into zrzut ekranu, wszystkie inne części strony są ignorowane. Jeśli istnieje wiele pasujących elementów HTML, wybierany jest pierwszy
    • Domyślnie: pusty
  • hideElement - identyfikator lub klasa Selektory CSS jednego lub więcej elementów HTML na stronie internetowej do ukrycia, aby określić wiele elementów HTML do ukrycia, oddziel każdy selektor przecinkiem
    • Domyślnie: pusty
  • waitForElement - identyfikator lub klasa Selektory CSS elementu HTML na stronie internetowej, który musi być widoczny przed wykonaniem przechwytywania
    • Domyślnie: pusty
  • requestAs - rodzaj agenta użytkownika, którego chcesz używać
    • Domyślnie: 0
    • Opcje:
      • 0 = wskazuje, że należy użyć klienta użytkownika standardowej przeglądarki
      • 1 = wskazuje, że należy użyć klienta użytkownika przeglądarki mobilnej
      • 2 = wskazuje, że należy użyć klienta użytkownika wyszukiwarki
      • 3 = wskazuje, że należy użyć klienta użytkownika podstawowej przeglądarki
  • customWaterMarkId - dodaj niestandardowy znak wodny do obrazu
    • Domyślnie: pusty
  • quality - w jakość zwróconego obrazu. To obecnie wpływa tylko na obrazy JPG, które mają domyślną kompresję 85%.
    • Zmniejszenie jakości zmniejszy rozmiar plików i skróci czas pobierania.
    • Domyślnie: -1
    • Minimum: -1
    • Maksymalna ilość znaków: 100
  • transparent - jeśli to prawda przechwytywanie obrazu powinno być przezroczyste. Jest to zgodne tylko z obrazami png i tiff.
    • Domyślnie: false
  • hd - jeśli to prawda, obraz przechwytywanie będzie w wysokiej rozdzielczości podwaja to rozmiar wymiarów obrazu.
    • Domyślnie: false
  • country - kraj zrzut ekranu powinien zostać pobrany.
    • Ostrzeżenie: ta funkcja jest obecnie w fazie beta i może nie zapewniać spójnych wyników.
    • Domyślnie: bieżąca najszybsza lokalizacja
    • Opcje: „SG”, „UK”, „US”
  • exportURL - w eksportuj adres URL określa, gdzie przechwytywanie powinno być również eksportowane
    • Domyślnie: pusty
  • encryptionKey - jeśli określono podstawowy klucz szyfrowania AES 64, twoje przechwytywanie jest szyfrowane podczas jego tworzenia. Zalecane jest użycie utwórz metodę klucza szyfrowania stworzyć klucz i metody deszyfrowania aby odszyfrować zaszyfrowane przechwycenie, jak pokazano w ten przykład.
    • Domyślnie: pusty
  • noAds - Jeśli prawda reklamy powinny być automatycznie ukryte.
    • Domyślnie: false
  • noCookieNotifications - jeśli to prawda, wszystkie powszechnie spotykane powiadomienia o plikach cookie powinny być automatycznie ukryte.
    • Domyślnie: false
  • address - adres URL do wykonania kodu HTML. Może być przydatny, jeśli używany jest konwertowany HTML względne adresy URL zasobów, takich jak CSS i obrazy.
    • Domyślnie: pusty
  • proxy - szczegóły proxy HTTP oprogramowanie przeglądarki powinno być użyte do utworzenia tego przechwytywania
    • Domyślnie: pusty

Metody publiczne

  • add_post_parameter (nazwa, wartość) - określa parametr HTTP Post i opcjonalnie wartość, tę metodę można wywołać wiele razy, aby dodać wiele parametrów. Użycie tej metody zmusi GrabzIt do wykonać post HTTP.
    • name - nazwa parametru HTTP Post
    • wartość - wartość parametru HTTP Post

url_to_rendered_html(url, Opcje = zero)

Określa adres URL, który należy przekonwertować into renderowany HTML.

parametry

  • url - adres URL, z którego powinien być wykonany renderowany HTML
    • wymagany
  • Opcje - instancja HTMLOptions klasa, która definiuje wszelkie specjalne opcje do użycia podczas tworzenia renderowanego HTML.

Wartość zwracana

unieważnić

html_to_rendered_html(html, Opcje = zero)

Określa kod HTML, który należy przekonwertować into renderowany HTML.

parametry

  • HTML - kod HTML do konwersji into renderowany HTML
    • wymagany
  • Opcje - instancja HTMLOptions klasa, która definiuje wszelkie specjalne opcje do użycia podczas tworzenia renderowanego HTML.

Wartość zwracana

unieważnić

file_to_rendered_html(ścieżka, Opcje = zero)

Określa plik HTML, który należy przekonwertować into renderowany HTML.

parametry

  • ścieżka - ścieżka pliku HTML do konwersji into renderowany HTML
    • wymagany
  • Opcje - instancja HTMLOptions klasa, która definiuje wszelkie specjalne opcje do użycia podczas tworzenia renderowanego HTML.

Wartość zwracana

unieważnić

HTMLOptions

Klasa reprezentuje wszystkie opcje dostępne, kiedy tworzenie renderowanych zrzutów HTML.

Właściwości publiczne

  • customId - niestandardowy identyfikator, który można przekazać do usługi internetowej. Zostanie to zwrócone z podanym adresem URL wywołania zwrotnego.
    • Domyślnie: pusty
  • browserWidth - szerokość przeglądarki w pikselach
    • Domyślnie: 1024
    • Maksymalna ilość znaków: 10000
  • browserHeight - wysokość przeglądarki w pikselach
    • Domyślnie: 768
    • Maksymalna ilość znaków: 10000
  • waitForElement - identyfikator lub klasa Selektory CSS elementu HTML na stronie internetowej, który musi być widoczny przed wykonaniem przechwytywania
    • Domyślnie: pusty
  • requestAs - rodzaj agenta użytkownika, którego chcesz używać
    • Domyślnie: 0
    • Opcje:
      • 0 = wskazuje, że należy użyć klienta użytkownika standardowej przeglądarki
      • 1 = wskazuje, że należy użyć klienta użytkownika przeglądarki mobilnej
      • 2 = wskazuje, że należy użyć klienta użytkownika wyszukiwarki
      • 3 = wskazuje, że należy użyć klienta użytkownika podstawowej przeglądarki
  • country - kraj zrzut ekranu powinien zostać pobrany.
    • Ostrzeżenie: ta funkcja jest obecnie w fazie beta i może nie zapewniać spójnych wyników.
    • Domyślnie: bieżąca najszybsza lokalizacja
    • Opcje: „SG”, „UK”, „US”
  • exportURL - w eksportuj adres URL określa, gdzie przechwytywanie powinno być również eksportowane
    • Domyślnie: pusty
  • encryptionKey - jeśli określono podstawowy klucz szyfrowania AES 64, twoje przechwytywanie jest szyfrowane podczas jego tworzenia. Zalecane jest użycie utwórz metodę klucza szyfrowania stworzyć klucz i metody deszyfrowania aby odszyfrować zaszyfrowane przechwycenie, jak pokazano w ten przykład.
    • Domyślnie: pusty
  • noAds - Jeśli prawda reklamy powinny być automatycznie ukryte.
    • Domyślnie: false
  • noCookieNotifications - jeśli to prawda, wszystkie powszechnie spotykane powiadomienia o plikach cookie powinny być automatycznie ukryte.
    • Domyślnie: false
  • address - adres URL do wykonania kodu HTML. Może być przydatny, jeśli używany jest konwertowany HTML względne adresy URL zasobów, takich jak CSS i obrazy.
    • Domyślnie: pusty
  • proxy - szczegóły proxy HTTP oprogramowanie przeglądarki powinno być użyte do utworzenia tego przechwytywania
    • Domyślnie: pusty

Metody publiczne

  • add_post_parameter (nazwa, wartość) - określa parametr HTTP Post i opcjonalnie wartość, tę metodę można wywołać wiele razy, aby dodać wiele parametrów. Użycie tej metody zmusi GrabzIt do wykonać post HTTP.
    • name - nazwa parametru HTTP Post
    • wartość - wartość parametru HTTP Post

url_to_pdf(url, Opcje = zero)

Określa adres URL, który należy przekonwertować into PDF.

parametry

  • url - adres URL, który należy przekonwertować into PDF
    • wymagany
  • Opcje - instancja klasy PDFOptions, która definiuje wszelkie specjalne opcje do użycia podczas tworzenia pliku PDF.

Wartość zwracana

unieważnić

html_to_pdf(html, Opcje = zero)

Określa kod HTML, który należy przekonwertować into PDF.

parametry

  • HTML - kod HTML do konwersji into PDF
    • wymagany
  • Opcje - instancja klasy PDFOptions, która definiuje wszelkie specjalne opcje do użycia podczas tworzenia pliku PDF.

Wartość zwracana

unieważnić

file_to_pdf(ścieżka, Opcje = zero)

Określa plik HTML, który należy przekonwertować into PDF.

parametry

  • ścieżka - ścieżka pliku HTML do konwersji into PDF
    • wymagany
  • Opcje - instancja klasy PDFOptions, która definiuje wszelkie specjalne opcje do użycia podczas tworzenia pliku PDF.

Wartość zwracana

unieważnić

PDFOpcje

Klasa reprezentuje wszystkie opcje dostępne podczas tworzenia zrzutów PDF.

Właściwości publiczne

  • customId - niestandardowy identyfikator, który można przekazać do usługi internetowej. Zostanie to zwrócone z podanym adresem URL wywołania zwrotnego.
    • Domyślnie: pusty
  • includeBackground - jeśli to prawda, zrzut ekranu powinien zawierać tło strony internetowej
    • Domyślnie: true
  • pagesize - rozmiar strony pliku PDF
    • Domyślnie: „A4”
    • Opcje: „A3”, „A4”, „A5”, „A6”, „B3”, „B4”, „B5”, „B6”, „Legal”, „Letter”
  • orientation - orientacja dokumentu PDF
    • Domyślnie: „Portret”
    • Opcje: „Portret”, „Krajobraz”
  • cssMediaType - w CSS Media Typ dokumentu PDF
    • Ekran domyślny"
    • Opcje: „Ekran”, „Parint"
  • includeLinks - prawda, jeśli linki powinny być zawarte w pliku PDF
    • Domyślnie: true
  • includeOutline - prawda, jeśli Zakładki PDF powinno być dołączone
    • Domyślnie: false
  • title - podać tytuł dokumentu PDF
    • Domyślnie: pusty
  • coverURL - adres URL strony internetowej, która powinna być używana jako strona tytułowa pliku PDF
    • Domyślnie: pusty
  • marginTop - margines w milimetrach, który powinien pojawić się u góry strony dokumentu PDF
    • Domyślnie: 10
  • marginLeft - margines w milimetrach, który powinien pojawić się po lewej stronie strony dokumentu PDF
    • Domyślnie: 10
  • marginBottom - margines w milimetrach, który powinien pojawić się na dole strony dokumentu PDF
    • Domyślnie: 10
  • marginRight - margines w milimetrach, który powinien pojawić się po prawej stronie dokumentu PDF
    • Domyślnie: 10
  • browserWidth - w szerokość przeglądarki w pikselach
    • Ostrzeżenie: ta funkcja jest obecnie w fazie beta i może nie zapewniać spójnych wyników.
    • Domyślnie: 1024
    • Maksymalna ilość znaków: 10000
    • Automatyczna szerokość: -1 (przekazanie -1 oznacza, że ​​szerokość przeglądarki odpowiada szerokości dokumentu PDF)
  • pageWidth - w niestandardowa szerokość wynikowego pliku PDF w mm
  • pageHeight - w niestandardowa wysokość wynikowego pliku PDF w mm
  • delay - liczba milisekund do poczekaj przed wykonaniem zrzutu ekranu
    • Domyślnie: 0
    • Maksymalna ilość znaków: 30000
  • requestAs - rodzaj agenta użytkownika, którego chcesz używać
    • Domyślnie: 0
    • Opcje:
      • 0 = wskazuje, że należy użyć klienta użytkownika standardowej przeglądarki
      • 1 = wskazuje, że należy użyć klienta użytkownika przeglądarki mobilnej
      • 2 = wskazuje, że należy użyć klienta użytkownika wyszukiwarki
      • 3 = wskazuje, że należy użyć klienta użytkownika podstawowej przeglądarki
  • templateId - dodać szablon Identyfikator określający nagłówek i stopkę dokumentu PDF
    • Domyślnie: pusty
  • targetElement - identyfikator lub klasa Selektor CSS jedynego elementu HTML na docelowej stronie internetowej, który ma zostać włączony into PDF, wszystkie inne części strony są ignorowane. Jeśli istnieje wiele pasujących elementów HTML, wybierany jest pierwszy
    • Domyślnie: pusty
  • hideElement - identyfikator lub klasa Selektory CSS jednego lub więcej elementów HTML na stronie internetowej do ukrycia, aby określić wiele elementów HTML do ukrycia, oddziel każdy selektor przecinkiem
    • Domyślnie: pusty
  • waitForElement - identyfikator lub klasa Selektory CSS elementu HTML na stronie internetowej, który musi być widoczny przed wykonaniem przechwytywania
    • Domyślnie: pusty
  • customWaterMarkId - dodaj niestandardowy znak wodny do każdej strony dokumentu PDF
    • Domyślnie: pusty
  • quality - w jakość zwróconego pliku PDF. Domyślnie używana jest zalecana jakość pliku PDF.
    • Zmniejszenie jakości zmniejszy rozmiar plików i skróci czas pobierania.
    • Domyślnie: -1
    • Minimum: -1
    • Maksymalna ilość znaków: 100
  • country - kraj zrzut ekranu powinien zostać pobrany.
    • Ostrzeżenie: ta funkcja jest obecnie w fazie beta i może nie zapewniać spójnych wyników.
    • Domyślnie: bieżąca najszybsza lokalizacja
    • Opcje: „SG”, „UK”, „US”
  • exportURL - w eksportuj adres URL określa, gdzie przechwytywanie powinno być również eksportowane
    • Domyślnie: pusty
  • encryptionKey - jeśli określono podstawowy klucz szyfrowania AES 64, twoje przechwytywanie jest szyfrowane podczas jego tworzenia. Zalecane jest użycie utwórz metodę klucza szyfrowania stworzyć klucz i metody deszyfrowania aby odszyfrować zaszyfrowane przechwycenie, jak pokazano w ten przykład.
    • Domyślnie: pusty
  • noAds - Jeśli prawda reklamy powinny być automatycznie ukryte.
    • Domyślnie: false
  • noCookieNotifications - jeśli to prawda, wszystkie powszechnie spotykane powiadomienia o plikach cookie powinny być automatycznie ukryte.
    • Domyślnie: false
  • address - adres URL do wykonania kodu HTML. Może być przydatny, jeśli używany jest konwertowany HTML względne adresy URL zasobów, takich jak CSS i obrazy.
    • Domyślnie: pusty
  • proxy - szczegóły proxy HTTP oprogramowanie przeglądarki powinno być użyte do utworzenia tego przechwytywania
    • Domyślnie: pusty
  • mergeId - identyfikator przechwytywania, który powinien być scalone na początku nowego dokumentu PDF
    • Domyślnie: pusty
  • password - w hasło do ochrony dokumentu PDF z
    • Domyślnie: pusty

Metody publiczne

  • add_post_parameter (nazwa, wartość) - określa parametr HTTP Post i opcjonalnie wartość, tę metodę można wywołać wiele razy, aby dodać wiele parametrów. Użycie tej metody zmusi GrabzIt do wykonać post HTTP.
    • name - nazwa parametru HTTP Post
    • wartość - wartość parametru HTTP Post
  • add_template_parameter (nazwa, wartość) - zdefiniować a szablon niestandardowy parametr i wartość, tę metodę można wywołać wiele razy, aby dodać wiele parametrów.
    • name - nazwa parametru szablonu
    • wartość - wartość parametru szablonu

url_to_docx(url, Opcje = zero)

Określa adres URL, który należy przekonwertować into DOCX.

parametry

  • url - adres URL, który należy przekonwertować into DOCX
    • wymagany
  • Opcje - instancja DOCXOptions klasa, która definiuje wszelkie specjalne opcje do użycia podczas tworzenia DOCX.

Wartość zwracana

unieważnić

html_to_docx(html, Opcje = zero)

Określa kod HTML, który należy przekonwertować into DOCX.

parametry

  • HTML - kod HTML do konwersji into DOCX
    • wymagany
  • Opcje - instancja DOCXOptions klasa, która definiuje wszelkie specjalne opcje do użycia podczas tworzenia DOCX.

Wartość zwracana

unieważnić

file_to_docx(ścieżka, Opcje = zero)

Określa plik HTML, który należy przekonwertować into DOCX.

parametry

  • ścieżka - ścieżka pliku HTML do konwersji into DOCX
    • wymagany
  • Opcje - instancja DOCXOptions klasa, która definiuje wszelkie specjalne opcje do użycia podczas tworzenia DOCX.

Wartość zwracana

unieważnić

DOCXOptions

Klasa reprezentuje wszystkie opcje dostępne podczas tworzenia przechwytywania DOCX.

Właściwości publiczne

  • customId - niestandardowy identyfikator, który można przekazać do usługi internetowej. Zostanie to zwrócone z podanym adresem URL wywołania zwrotnego.
    • Domyślnie: pusty
  • includeBackground - jeśli to prawda, obrazy tła strony internetowej powinny być zawarte w DOCX
    • Domyślnie: true
  • pagesize - rozmiar strony DOCX
    • Domyślnie: „A4”
    • Opcje: „A3”, „A4”, „A5”, „A6”, „B3”, „B4”, „B5”, „B6”, „Legal”, „Letter”
  • orientation - orientacja dokumentu DOCX
    • Domyślnie: „Portret”
    • Opcje: „Portret”, „Krajobraz”
  • includeLinks - prawda, jeśli linki powinny być zawarte w DOCX
    • Domyślnie: true
  • includeImages - jeśli to prawda, obrazy strony internetowej powinny być zawarte w DOCX
    • Domyślnie: true
  • title - podać tytuł dokumentu DOCX
    • Domyślnie: pusty
  • marginTop - margines w milimetrach, który powinien pojawić się na górze strony dokumentu DOCX
    • Domyślnie: 10
  • marginLeft - margines w milimetrach, który powinien pojawić się po lewej stronie strony dokumentu DOCX
    • Domyślnie: 10
  • marginBottom - margines w milimetrach, który powinien pojawić się na dole strony dokumentu DOCX
    • Domyślnie: 10
  • marginRight - margines w milimetrach, który powinien pojawić się po prawej stronie dokumentu DOCX
    • Domyślnie: 10
  • browserWidth - w szerokość przeglądarki w pikselach
    • Ostrzeżenie: ta funkcja jest obecnie w fazie beta i może nie zapewniać spójnych wyników.
    • Domyślnie: 1024
    • Maksymalna ilość znaków: 10000
    • Automatyczna szerokość: -1 (przekazanie -1 oznacza, że ​​szerokość przeglądarki odpowiada szerokości dokumentu DOCX)
  • pageWidth - w niestandardowa szerokość wynikowego DOCX w mm
  • pageHeight - w niestandardowa wysokość wynikowego DOCX w mm
  • delay - liczba milisekund do poczekaj przed wykonaniem zrzutu ekranu
    • Domyślnie: 0
    • Maksymalna ilość znaków: 30000
  • requestAs - rodzaj agenta użytkownika, którego chcesz używać
    • Domyślnie: 0
    • Opcje:
      • 0 = wskazuje, że należy użyć klienta użytkownika standardowej przeglądarki
      • 1 = wskazuje, że należy użyć klienta użytkownika przeglądarki mobilnej
      • 2 = wskazuje, że należy użyć klienta użytkownika wyszukiwarki
      • 3 = wskazuje, że należy użyć klienta użytkownika podstawowej przeglądarki
  • templateId - dodać szablon Identyfikator określający nagłówek i stopkę dokumentu DOCX
    • Domyślnie: pusty
  • targetElement - identyfikator lub klasa Selektor CSS jedynego elementu HTML na docelowej stronie internetowej, który ma zostać włączony into DOCX, wszystkie inne części strony są ignorowane. Jeśli istnieje wiele pasujących elementów HTML, wybierany jest pierwszy
    • Domyślnie: pusty
  • hideElement - identyfikator lub klasa Selektory CSS jednego lub więcej elementów HTML na stronie internetowej do ukrycia, aby określić wiele elementów HTML do ukrycia, oddziel każdy selektor przecinkiem
    • Domyślnie: pusty
  • waitForElement - identyfikator lub klasa Selektory CSS elementu HTML na stronie internetowej, który musi być widoczny przed wykonaniem przechwytywania
    • Domyślnie: pusty
  • quality - w jakość zwróconego DOCX. Domyślnie używana jest zalecana jakość dla DOCX.
    • Zmniejszenie jakości zmniejszy rozmiar plików i skróci czas pobierania.
    • Domyślnie: -1
    • Minimum: -1
    • Maksymalna ilość znaków: 100
  • country - kraj zrzut ekranu powinien zostać pobrany.
    • Ostrzeżenie: ta funkcja jest obecnie w fazie beta i może nie zapewniać spójnych wyników.
    • Domyślnie: bieżąca najszybsza lokalizacja
    • Opcje: „SG”, „UK”, „US”
  • exportURL - w eksportuj adres URL określa, gdzie przechwytywanie powinno być również eksportowane
    • Domyślnie: pusty
  • encryptionKey - jeśli określono podstawowy klucz szyfrowania AES 64, twoje przechwytywanie jest szyfrowane podczas jego tworzenia. Zalecane jest użycie utwórz metodę klucza szyfrowania stworzyć klucz i metody deszyfrowania aby odszyfrować zaszyfrowane przechwycenie, jak pokazano w ten przykład.
    • Domyślnie: pusty
  • noAds - Jeśli prawda reklamy powinny być automatycznie ukryte.
    • Domyślnie: false
  • noCookieNotifications - jeśli to prawda, wszystkie powszechnie spotykane powiadomienia o plikach cookie powinny być automatycznie ukryte.
    • Domyślnie: false
  • address - adres URL do wykonania kodu HTML. Może być przydatny, jeśli używany jest konwertowany HTML względne adresy URL zasobów, takich jak CSS i obrazy.
    • Domyślnie: pusty
  • proxy - szczegóły proxy HTTP oprogramowanie przeglądarki powinno być użyte do utworzenia tego przechwytywania
    • Domyślnie: pusty
  • mergeId - identyfikator przechwytywania, który powinien być scalone na początku nowego dokumentu DOCX
    • Domyślnie: pusty
  • password - w hasło do ochrony dokumentu DOCX z
    • Domyślnie: pusty

Metody publiczne

  • add_post_parameter (nazwa, wartość) - określa parametr HTTP Post i opcjonalnie wartość, tę metodę można wywołać wiele razy, aby dodać wiele parametrów. Użycie tej metody zmusi GrabzIt do wykonać post HTTP.
    • name - nazwa parametru HTTP Post
    • wartość - wartość parametru HTTP Post
  • add_template_parameter (nazwa, wartość) - zdefiniować a szablon niestandardowy parametr i wartość, tę metodę można wywołać wiele razy, aby dodać wiele parametrów.
    • name - nazwa parametru szablonu
    • wartość - wartość parametru szablonu

url_to_table(url, Opcje = zero)

Określa adres URL, z którego należy wyodrębnić tabele HTML.

parametry

  • url - adres URL do wyodrębnienia tabel HTML
    • wymagany
  • Opcje - instancja TableOptions klasa, która definiuje wszelkie specjalne opcje do użycia podczas konwertowania tabeli HTML.

Wartość zwracana

unieważnić

html_to_table(html, Opcje = zero)

Określa kod HTML, z którego należy wyodrębnić tabele HTML.

parametry

  • html - HTML, z którego można wyodrębnić tabele HTML.
    • wymagany
  • Opcje - instancja TableOptions klasa, która definiuje wszelkie specjalne opcje do użycia podczas konwertowania tabeli HTML.

Wartość zwracana

unieważnić

file_to_table(ścieżka, Opcje = zero)

Określa plik HTML, z którego należy wyodrębnić tabele HTML.

parametry

  • ścieżka - ścieżka pliku HTML, z którego można wyodrębnić tabele HTML.
    • wymagany
  • Opcje - instancja TableOptions klasa, która definiuje wszelkie specjalne opcje do użycia podczas konwertowania tabeli HTML.

Wartość zwracana

unieważnić

TableOptions

Klasa reprezentuje wszystkie opcje dostępne podczas konwersji tabel HTML na CSV, XLSX lub JSON.

Właściwości publiczne

  • customId - niestandardowy identyfikator, który można przekazać do usługi internetowej. Zostanie to zwrócone z podanym adresem URL wywołania zwrotnego
    • Domyślnie: pusty
  • tableNumberToInclude - indeks tabeli do przekonwertowania, w której wszystkie tabele na stronie internetowej są uporządkowane od góry strony do dołu
    • Domyślnie: 1
  • format - format, w jakim powinna być tabela
    • Domyślnie: „csv”
    • Opcje: „csv”, „json”, „xlsx”
  • includeHeaderNames - jeśli prawdziwe nazwy nagłówków zostaną uwzględnione w tabeli
    • Domyślnie: true
  • includeAllTables - jeśli to prawda, wszystkie tabele na stronie internetowej zostaną wyodrębnione, a każdy z nich pojawi się w osobnym arkuszu kalkulacyjnym. Dostępne tylko w formacie XLSX
    • Domyślnie: false
  • targetElement - identyfikator jedynego elementu HTML na stronie internetowej, którego należy użyć do wyodrębnienia tabel
    • Domyślnie: pusty
  • requestAs - rodzaj agenta użytkownika, którego chcesz używać
    • Domyślnie: 0
    • Opcje:
      • 0 = wskazuje, że należy użyć klienta użytkownika standardowej przeglądarki
      • 1 = wskazuje, że należy użyć klienta użytkownika przeglądarki mobilnej
      • 2 = wskazuje, że należy użyć klienta użytkownika wyszukiwarki
      • 3 = wskazuje, że należy użyć klienta użytkownika podstawowej przeglądarki
  • country - kraj zrzut ekranu powinien zostać pobrany.
    • Ostrzeżenie: ta funkcja jest obecnie w fazie beta i może nie zapewniać spójnych wyników.
    • Domyślnie: bieżąca najszybsza lokalizacja
    • Opcje: „SG”, „UK”, „US”
  • exportURL - w eksportuj adres URL określa, gdzie przechwytywanie powinno być również eksportowane
    • Domyślnie: pusty
  • encryptionKey - jeśli określono podstawowy klucz szyfrowania AES 64, twoje przechwytywanie jest szyfrowane podczas jego tworzenia. Zalecane jest użycie utwórz metodę klucza szyfrowania stworzyć klucz i metody deszyfrowania aby odszyfrować zaszyfrowane przechwycenie, jak pokazano w ten przykład.
    • Domyślnie: pusty
  • address - adres URL do wykonania kodu HTML. Może być przydatny, jeśli używany jest konwertowany HTML względne adresy URL zasobów, takich jak CSS i obrazy.
    • Domyślnie: pusty
  • proxy - szczegóły proxy HTTP oprogramowanie przeglądarki powinno być użyte do utworzenia tego przechwytywania
    • Domyślnie: pusty

Metody publiczne

  • add_post_parameter (nazwa, wartość) - określa parametr HTTP Post i opcjonalnie wartość, tę metodę można wywołać wiele razy, aby dodać wiele parametrów. Użycie tej metody zmusi GrabzIt do wykonać post HTTP.
    • name - nazwa parametru HTTP Post
    • wartość - wartość parametru HTTP Post

Jest to zalecana metoda zapisywania pliku

save(callBackURL = zero)

Save wynik asynchronicznie i zwraca unikalny identyfikator, którego można użyć do uzyskania zrzutu ekranu z get_result Metoda.

parametry

  • callBackURL - treser usługa GrabzIt powinna zadzwonić po zakończeniu pracy

Wartość zwracana

Unikalny identyfikator zrzutu ekranu, w przeciwnym razie, jeśli wystąpi błąd, zgłoszony zostanie wyjątek. Można tego użyć do pobrania zrzutu ekranu za pomocą metody get_result


Ostrzeżenie: ta metoda jest synchroniczna, więc spowoduje zatrzymanie aplikacji podczas przetwarzania wyniku

save_to()

Save wynik synchronicznie do zmiennej zawierającej dane bajtu zrzutu ekranu.

Wartość zwracana

zwraca dane bajtowe pliku, jeśli zakończy się powodzeniem, w przeciwnym razie zgłasza wyjątek.


Ostrzeżenie: ta metoda jest synchroniczna, więc spowoduje zatrzymanie aplikacji podczas przetwarzania wyniku

save_to(saveDo pliku)

Save wynik synchronicznie do pliku.

parametry

  • saveToFile - ścieżka przechwytywania pliku saved po zakończeniu
    • wymagany

Wartość zwracana

zwraca prawdę, jeśli się powiedzie, w przeciwnym razie zgłasza wyjątek.


get_status(ID)

Uzyskaj aktualny status zrzutu ekranu GrabzIt.

parametry

  • id - unikalny identyfikator zrzutu ekranu
    • wymagany

Wartość zwracana

ScreenShotStatus przedmiot


get_cookies(domena)

Zdobądź wszystkie pliki cookie, których używa GrabzIt dla określonej domeny. Może to również obejmować pliki cookie zdefiniowane przez użytkownika.

parametry

  • domena - domena, dla której zwracane są pliki cookie
    • wymagany

Wartość zwracana

ciastko szyk


set_cookie (nazwa, domena, wartość = "", ścieżka = "/", httponly = fałsz, wygasa = "")

Ustawia nowy niestandardowy plik cookie w GrabzIt, jeśli niestandardowy plik cookie ma taką samą nazwę i domenę jak globalny plik cookie, globalny plik cookie zostanie zastąpiony.

Może to być przydatne, jeśli funkcjonalność strony internetowej jest kontrolowana przez pliki cookie.

parametry

  • nazwa - nazwa pliku cookie, który należy ustawić
    • wymagany
  • domena - domena strony internetowej, dla której ma zostać ustawiony plik cookie
    • wymagany
  • wartość - wartość pliku cookie
  • ścieżka - ścieżka do strony, której dotyczy plik cookie
  • httponly - jeśli to prawda, plik cookie może być używany tylko z protokołem HTTP
  • wygasa - określa, kiedy wygasa plik cookie. Podaj zero, jeśli plik cookie nie wygasa
    • Powinien być w formacie rrrr-mm-dd gg: mm: ss

Wartość zwracana

Prawda, jeśli plik cookie został pomyślnie ustawiony, w przeciwnym razie fałsz


delete_cookie (nazwa, domena)

Usuń niestandardowy plik cookie lub zablokuj używanie globalnego pliku cookie

parametry

  • nazwa - nazwa pliku cookie do usunięcia
    • wymagany
  • domena - domena strony internetowej, dla której chcesz usunąć plik cookie
    • wymagany

Wartość zwracana

Prawda, jeśli plik cookie zostanie pomyślnie usunięty, w przeciwnym razie fałsz


get_watermarks ()

Uzyskaj przesłane niestandardowe znaki wodne

Wartość zwracana

WaterMark szyk


get_watermark (identyfikator)

Uzyskaj przesłane niestandardowe znaki wodne

parametry

  • identyfikator - identyfikator określonego niestandardowego znaku wodnego, który chcesz wyświetlić
    • wymagany

Wartość zwracana

WaterMark


add_watermark (identyfikator, ścieżka, XP, YPO)

Dodaj nowy niestandardowy znak wodny

parametry

  • identyfikator - identyfikator, który chcesz nadać niestandardowemu znakowi wodnemu. Ważne jest, aby ten identyfikator był unikalny.
    • wymagany
  • ścieżka - bezwzględna ścieżka znaku wodnego na twoim serwerze. Na przykład C: /watermark/1.png
    • wymagany
  • xpos - pozycja pozioma, na której ma się pojawić zrzut ekranu
    • wymagany
    • Opcje:
      • Lewy = 0
      • Centrum = 1
      • Prawo = 2
  • ypos - pozycja pionowa, w której ma się pojawić zrzut ekranu
    • wymagany
    • Opcje:
      • Góra = 0
      • Middle = 1
      • Dół = 2

Wartość zwracana

zwraca true, jeśli znak wodny został pomyślnie ustawiony


delete_watermark (identyfikator)

Usuń niestandardowy znak wodny

parametry

  • identyfikator - identyfikator niestandardowego znaku wodnego, który chcesz usunąć
    • wymagany

Wartość zwracana

zwraca true, jeśli znak wodny został pomyślnie usunięty


set_local_proxy (wartość)

Ta metoda umożliwia lokalny serwer proxy do wykorzystania we wszystkich żądaniach.

parametry

  • proxyUrl - adres URL, który w razie potrzeby może zawierać port serwera proxy. Podanie wartości null spowoduje usunięcie wcześniej ustawionego serwera proxy
    • wymagany

use_ssl (wartość)

Określa, czy żądania do GrabzIt's Interfejs API powinien używać protokołu SSL

parametry

  • wartość - jeśli ma wartość true, wszystkie żądania do interfejsu API GrabzIt będą używać protokołu SSL
    • wymagany

create_encryption_key ()

Utwórz kryptograficznie bezpieczny podstawowy klucz szyfrowania 64 o długości znaków 44.


odszyfrować (dane, klucz)

Odszyfruj zaszyfrowane przechwycenie za pomocą dostarczonego klucza szyfrowania.

parametry


plik deszyfrujący (ścieżka, klucz)

Odszyfruj zaszyfrowane przechwycenie za pomocą dostarczonego klucza szyfrowania.

parametry

  • ścieżka - ścieżka zaszyfrowanego przechwytywania
    • wymagany
  • klucz - klucz szyfrujący
    • wymagany

Klasy wyników

ciastko

Właściwości publiczne

  • name
    • Nazwa ciasteczka
  • value
    • Wartość pliku cookie.
  • domain
    • Domena, dla której ustawiony jest plik cookie.
  • path
    • Ścieżka do domeny, której dotyczy ten plik cookie.
  • httpOnly
    • Jeśli ten plik cookie jest ważny tylko wtedy, gdy witryna jest przeglądana za pomocą protokołu HTTP.
  • expires
    • Data wygaśnięcia tego pliku cookie
  • type
    • Jest to rodzaj pliku cookie, który może być jednym z następujących:
      • Globalny - jest to globalny plik cookie ustawiony przez GrabzIt
      • Lokalny - to lokalny plik cookie ustawiony przez Ciebie
      • Zastąpione - globalne ciasteczko, które zostało przez Ciebie zastąpione

ScreenShotStatus

Klasa reprezentująca bieżący status zrzutu ekranu.

Właściwości publiczne

  • processing
    • Jeśli true, zrzut ekranu jest nadal przetwarzany.
  • cached
    • Jeśli true, zrzut ekranu został przetworzony i jest obecnie buforowany.
  • expired
    • Jeśli to prawda, zrzut ekranu nie jest już dostępny w systemie GrabzIt.
  • message
    • Komunikat o błędzie zwrócony przez system.

WaterMark

Ta klasa reprezentuje niestandardowe znaki wodne przechowywane w GrabzIt

Właściwości publiczne

  • identifier
    • Identyfikator znaku wodnego
  • xPosition
    • Pozioma pozycja znaku wodnego
      • Lewy = 0
      • Centrum = 1
      • Prawo = 2
  • yPosition
    • Pionowa pozycja znaku wodnego
      • Góra = 0
      • Middle = 1
      • Dół = 2
  • format
    • Format znaku wodnego