Opis
Ta klasa obsługuje całą komunikację z usługami zrzutów ekranu GrabzIt.
Metody publiczne
- get_result(id)
- url_to_animation(url, options = nil)
- url_to_image(url, options = nil)
- html_to_image(html, options = nil)
- file_to_image(path, options = nil)
- url_to_pdf(url, options = nil)
- html_to_pdf(html, options = nil)
- file_to_pdf(path, options = nil)
- url_to_docx(url, options = nil)
- html_to_docx(html, options = nil)
- file_to_docx(path, options = nil)
- url_to_table(url, options = nil)
- html_to_table(html, options = nil)
- file_to_table(path, options = nil)
- url_to_rendered_html(url, options = nil)
- html_to_rendered_html(html, options = nil)
- file_to_rendered_html(path, options = nil)
- save(callBackURL = nil)
- save_to()
- save_to(saveToFile)
- get_status(id)
- get_cookies(domain)
- set_cookie(name, domain, value = "", path = "/", httponly = false, expires = "")
- delete_cookie(name, domain)
- get_watermarks()
- get_watermark(identifier)
- add_watermark(identifier, path, xpos, ypos)
- delete_watermark(identifier)
- set_local_proxy(value)
- use_ssl(value)
- create_encryption_key()
- decrypt(path, key)
- decrypt_file(path, key)
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
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.
- Wymagane
-
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.
-
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.
-
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
- Nigdy nie pętla: -1
-
reverse - jeśli to prawda, ramki animowanego GIF-a są odwrócone
-
customWaterMarkId - dodaj niestandardowe watermark do animowanego GIF-a
-
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.
- Domyślnie: bieżąca najszybsza lokalizacja
- Opcje: „SG”, „UK”, „US”
-
exportURL - w eksportuj adres URL określa, gdzie przechwytywanie powinno być również eksportowane
-
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.
-
proxy - szczegóły proxy HTTP oprogramowanie przeglądarki powinno być użyte do utworzenia tego przechwytywania
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
- 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
- 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
- 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.
-
browserWidth - szerokość przeglądarki w pikselach
- Domyślnie: 1366
- Maksymalna ilość znaków: 10000
-
browserHeight - wysokość przeglądarki w pikselach
- Domyślnie: 1170
- 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: jeśli nie określono zarówno szerokości wyjściowej, jak i wysokości wyjściowej lub 0, wówczas szerokość i wysokość wyjściowa będą zgodne z ostateczną szerokością i wysokością obrazu, jeśli określono wysokość wyjściową, szerokość wyjściowa będzie proporcjonalna do wysokości wyjściowej
- 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: jeśli nie określono zarówno szerokości wyjściowej, jak i wysokości wyjściowej lub 0, wówczas szerokość i wysokość wyjściowa będą zgodne z ostateczną szerokością i wysokością obrazu, jeśli określono szerokość wyjściową, wysokość wyjściowa będzie proporcjonalna do szerokości wyjściowej
- 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
-
clickElement - określa element HTML, używając pliku Selektor CSS kliknąć. Pamiętaj, że opóźnienie może być również wymagane do wyświetlenia efektów kliknięcia
- Ostrzeżenie: ta funkcja jest obecnie w fazie beta i może nie zapewniać spójnych wyników.
-
targetElement - w 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
-
hideElement - w 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
-
waitForElement - w Selektory CSS elementu HTML na stronie internetowej, który musi być widoczny przed wykonaniem przechwytywania
-
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
-
customWaterMarkId - dodaj niestandardowy watermark do obrazu
-
quality - w jakość zwróconego obrazu. Obecnie wpływa to tylko na obrazy JPG i WEBP, które mają domyślną kompresję 90%.
- 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.
-
hd - jeśli to prawda, obraz przechwytywanie będzie w wysokiej rozdzielczości podwaja to rozmiar wymiarów obrazu.
-
country - kraj zrzut ekranu powinien zostać pobrany.
- Domyślnie: bieżąca najszybsza lokalizacja
- Opcje: „SG”, „UK”, „US”
-
exportURL - w eksportuj adres URL określa, gdzie przechwytywanie powinno być również eksportowane
-
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.
-
noAds - Jeśli prawda reklamy powinny być automatycznie ukryte.
-
noCookieNotifications - jeśli to prawda, wszystkie powszechnie spotykane powiadomienia o plikach cookie powinny być automatycznie ukryte.
-
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.
-
proxy - szczegóły proxy HTTP oprogramowanie przeglądarki powinno być użyte do utworzenia tego przechwytywania
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
- 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
- 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
- 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.
-
browserWidth - szerokość przeglądarki w pikselach
- Domyślnie: 1366
- Maksymalna ilość znaków: 10000
-
browserHeight - wysokość przeglądarki w pikselach
- Domyślnie: 1170
- Maksymalna ilość znaków: 10000
-
waitForElement - w Selektory CSS elementu HTML na stronie internetowej, który musi być widoczny przed wykonaniem przechwytywania
-
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
-
country - kraj zrzut ekranu powinien zostać pobrany.
- Domyślnie: bieżąca najszybsza lokalizacja
- Opcje: „SG”, „UK”, „US”
-
exportURL - w eksportuj adres URL określa, gdzie przechwytywanie powinno być również eksportowane
-
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.
-
noAds - Jeśli prawda reklamy powinny być automatycznie ukryte.
-
noCookieNotifications - jeśli to prawda, wszystkie powszechnie spotykane powiadomienia o plikach cookie powinny być automatycznie ukryte.
-
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.
-
proxy - szczegóły proxy HTTP oprogramowanie przeglądarki powinno być użyte do utworzenia tego przechwytywania
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
- 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
- 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
- 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.
-
includeBackground - jeśli to prawda, zrzut ekranu powinien zawierać tło strony internetowej
-
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
-
includeOutline - prawda, jeśli Zakładki PDF powinno być dołączone
-
title - podać tytuł dokumentu PDF
-
coverURL - adres URL strony internetowej, która powinna być używana jako strona tytułowa pliku PDF
-
marginTop - margines w milimetrach, który powinien pojawić się u góry strony dokumentu PDF
-
marginLeft - margines w milimetrach, który powinien pojawić się po lewej stronie strony dokumentu PDF
-
marginBottom - margines w milimetrach, który powinien pojawić się na dole strony dokumentu PDF
-
marginRight - margines w milimetrach, który powinien pojawić się po prawej stronie dokumentu PDF
-
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: 1366
- 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
-
templateId - dodać szablon Identyfikator określający nagłówek i stopkę dokumentu PDF
-
clickElement - określa element HTML, używając pliku Selektor CSS kliknąć. Pamiętaj, że opóźnienie może być również wymagane do wyświetlenia efektów kliknięcia
- Ostrzeżenie: ta funkcja jest obecnie w fazie beta i może nie zapewniać spójnych wyników.
-
targetElement - w Selektor CSS jedyny Element HTML na docelowej stronie internetowej, która ma zostać odwrócona into PDF, wszystkie inne części strony są ignorowane. Jeśli istnieje wiele pasujących elementów HTML, wybierany jest pierwszy
-
hideElement - w 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
-
waitForElement - w Selektory CSS elementu HTML na stronie internetowej, który musi być widoczny przed wykonaniem przechwytywania
-
customWaterMarkId - dodaj niestandardowy watermark na każdej stronie dokumentu PDF
-
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.
- Domyślnie: bieżąca najszybsza lokalizacja
- Opcje: „SG”, „UK”, „US”
-
exportURL - w eksportuj adres URL określa, gdzie przechwytywanie powinno być również eksportowane
-
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.
-
noAds - Jeśli prawda reklamy powinny być automatycznie ukryte.
-
noCookieNotifications - jeśli to prawda, wszystkie powszechnie spotykane powiadomienia o plikach cookie powinny być automatycznie ukryte.
-
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.
-
proxy - szczegóły proxy HTTP oprogramowanie przeglądarki powinno być użyte do utworzenia tego przechwytywania
-
mergeId - identyfikator przechwytywania, który powinien być scalone na początku nowego dokumentu PDF
-
password - w hasło do ochrony dokumentu PDF z
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
- 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
- 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
- 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.
-
includeBackground - jeśli to prawda, obrazy tła strony internetowej powinny być zawarte w DOCX
-
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
-
includeImages - jeśli to prawda, obrazy strony internetowej powinny być zawarte w DOCX
-
title - podać tytuł dokumentu DOCX
-
marginTop - margines w milimetrach, który powinien pojawić się na górze strony dokumentu DOCX
-
marginLeft - margines w milimetrach, który powinien pojawić się po lewej stronie strony dokumentu DOCX
-
marginBottom - margines w milimetrach, który powinien pojawić się na dole strony dokumentu DOCX
-
marginRight - margines w milimetrach, który powinien pojawić się po prawej stronie dokumentu DOCX
-
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: 1366
- 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
-
templateId - dodać szablon Identyfikator określający nagłówek i stopkę dokumentu DOCX
-
clickElement - określa element HTML, używając pliku Selektor CSS kliknąć. Pamiętaj, że opóźnienie może być również wymagane do wyświetlenia efektów kliknięcia
- Ostrzeżenie: ta funkcja jest obecnie w fazie beta i może nie zapewniać spójnych wyników.
-
targetElement - w 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
-
hideElement - w 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
-
waitForElement - w Selektory CSS elementu HTML na stronie internetowej, który musi być widoczny przed wykonaniem przechwytywania
-
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.
- Domyślnie: bieżąca najszybsza lokalizacja
- Opcje: „SG”, „UK”, „US”
-
exportURL - w eksportuj adres URL określa, gdzie przechwytywanie powinno być również eksportowane
-
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.
-
noAds - Jeśli prawda reklamy powinny być automatycznie ukryte.
-
noCookieNotifications - jeśli to prawda, wszystkie powszechnie spotykane powiadomienia o plikach cookie powinny być automatycznie ukryte.
-
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.
-
proxy - szczegóły proxy HTTP oprogramowanie przeglądarki powinno być użyte do utworzenia tego przechwytywania
-
mergeId - identyfikator przechwytywania, który powinien być scalone na początku nowego dokumentu DOCX
-
password - w hasło do ochrony dokumentu DOCX z
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
- 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.
- 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.
- 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
-
tableNumberToInclude - indeks tabeli do przekonwertowania, w której wszystkie tabele na stronie internetowej są uporządkowane od góry strony do dołu
-
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
-
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
-
targetElement - identyfikator jedynego elementu HTML na stronie internetowej, którego należy użyć do wyodrębnienia tabel
-
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
-
country - kraj zrzut ekranu powinien zostać pobrany.
- Domyślnie: bieżąca najszybsza lokalizacja
- Opcje: „SG”, „UK”, „US”
-
exportURL - w eksportuj adres URL określa, gdzie przechwytywanie powinno być również eksportowane
-
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.
-
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.
-
proxy - szczegóły proxy HTTP oprogramowanie przeglądarki powinno być użyte do utworzenia tego przechwytywania
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(saveToPlik)
Save wynik synchronicznie do pliku.
parametry
-
saveToPlik - ścieżka do pliku, który będzie przechwytywany saved po zakończeniu
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
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
Wartość zwracana
Cookies
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ć
-
domena - domena strony internetowej, dla której ma zostać ustawiony plik cookie
- 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
-
domena - domena strony internetowej, dla której chcesz usunąć plik cookie
Wartość zwracana
Prawda, jeśli plik cookie zostanie pomyślnie usunięty, w przeciwnym razie fałsz
dostać_watermarks()
Pobierz przesłany plik niestandardowy watermarks
Wartość zwracana
WaterMark szyk
dostać_watermark(identyfikator)
Pobierz przesłany plik niestandardowy watermarks
parametry
-
identyfikator - identyfikator konkretnego zwyczaju watermark chcesz zobaczyć
Wartość zwracana
WaterMark
Dodaj_watermark(identyfikator, ścieżka, XP, YPO)
Dodaj nowy zwyczaj watermark
parametry
-
identyfikator - identyfikator, który chcesz nadać niestandardowemu watermark. Ważne jest, aby ten identyfikator był niepowtarzalny.
-
path - bezwzględna ścieżka pliku watermark na twoim serwerze. Na przykład C: /watermark/1.png
-
xpos - pozycja pozioma, na której ma się pojawić zrzut ekranu
- Wymagane
-
Opcje:
- Lewy = 0
- Centrum = 1
- Prawo = 2
-
ypos - pozycja pionowa, w której ma się pojawić zrzut ekranu
- Wymagane
-
Opcje:
- Góra = 0
- Middle = 1
- Dół = 2
Wartość zwracana
zwraca prawdę, jeśli watermark został pomyślnie ustawiony
usunąć_watermark(identyfikator)
Usuń niestandardowy watermark
parametry
-
identyfikator - identyfikator zwyczaju watermark chcesz usunąć
Wartość zwracana
zwraca prawdę, jeśli watermark 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
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
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
Klasy wyników
Cookies
Właściwości publiczne
-
name
-
value
-
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 watermarks przechowywane w GrabzIt
Właściwości publiczne
-
identifier
-
xPosition
-
Poziome położenie watermark
- Lewy = 0
- Centrum = 1
- Prawo = 2
-
yPosition
-
Pionowa pozycja watermark
- Góra = 0
- Middle = 1
- Dół = 2
-
format