Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Net::Google::SafeBrowsUser:Contributed PeNet::Google::SafeBrowsing2::Lookup(3)

NAME
       Net::Google::SafeBrowsing2::Lookup - Perl extension for the Google Safe
       Browsing	v2 Lookup API.

SYNOPSIS
	 use Net::Google::SafeBrowsing2::Lookup;

	 my $gsb = Net::Google::SafeBrowsing2::Lookup->new(
	       key     => "my key",
	 );

	 my %match = $gsb->lookup(url => 'http://www.gumblar.cn/');

	 if ($match{'http://www.gumblar.cn/'} eq 'malware') {
	       print "http://www.gumblar.cn/ is	flagged	as a dangerous site\n";
	 }

	 my %matches = $gsb->lookup(urls => ['http://www.gumblar.cn/', 'http://flahupdate.co.cc']);
	 foreach my $url (keys %matches) {
	   print $url, " is ", $matches{$url}, "\n";
	 }

DESCRIPTION
       Net::Google::SafeBrowsing2::Lookup implements the Google	Safe Browsing
       v2 Lookup API. See the API documentation	at
       <http://code.google.com/apis/safebrowsing/lookup_guide.html>.

       If you need to check more than 10,000 URLs a day, you need to use
       Net::Google::SafeBrowsing2.

       The source code is available on github at
       <https://github.com/juliensobrier/Net-Google-SafeBrowsing2>.

CONSTRUCTOR
   new()
       Create a	Net::Google::SafeBrowsing2::Lookup object

	 my $gsb = Net::Google::SafeBrowsing2::Lookup->new(
	       key     => "my key",
	       debug   => 0,
	 );

       Arguments

       key Required. Your Google Safe Browsing API key

       debug
	   Optional. Set to 1 to enable	debugging. 0 (disabled)	by default.

	   The debug output maybe quite	large and can slow down	significantly
	   the update and lookup functions.

       errors
	   Optional. Set to 1 to show errors to	STDOUT.	0 (disabled by
	   default).

       version
	   Optional. Google Safe Browsing version. 3.0 by default

       delay
	   Optional. Delay, in seconds,	between	2 requests to the Google
	   server. See the "lookup" function for more details. 0 (no delay) by
	   default

PUBLIC FUNCTIONS
   lookup()
       Lookup a	list URLs against the Google Safe Browsing v2 lists.

	 my %match = $gsb->lookup(url => 'http://www.gumblar.cn');

       Returns a hash "url" => "Google match". The possible list of values for
       "Google match" are: "ok"	(no match), "malware", "phishing",
       "malware,phishing" (match both lists) and "error".

       Arguments

       url Optional. Single URL	to lookup.

       urls
	   Optional. List of URLs to lookup.

	   The Lookup API allows only 10,000 URL checks	a day. if you need
	   more, use the Net::Google::SafeBrowsing2 library.

	   Each	requests must contain 500 URLs at most.	The lookup() method
	   will	split the list of URLS in blocks of 500	URLs if	needed.

       delay
	   Optional. If	more than 500 URLs are checked,	wait "delay" seconds
	   between consecutive requests	to avoid rate limiting by Google.

CHANGELOG
       0.2 Documentation update.

SEE ALSO
       See Net::Google::SafeBrowsing2 for the implementation of	Google Safe
       Browsing	v2 API.

AUTHOR
       Julien Sobrier, <jsobrier@zscaler.com> or <julien@sobrier.net>

COPYRIGHT AND LICENSE
       Copyright (C) 2012 by Julien Sobrier

       This library is free software; you can redistribute it and/or modify it
       under the same terms as Perl itself, either Perl	version	5.8.8 or, at
       your option, any	later version of Perl 5	you may	have available.

perl v5.32.1			  2013-06Net::Google::SafeBrowsing2::Lookup(3)

NAME | SYNOPSIS | DESCRIPTION | CONSTRUCTOR | PUBLIC FUNCTIONS | CHANGELOG | SEE ALSO | AUTHOR | COPYRIGHT AND LICENSE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Net::Google::SafeBrowsing2::Lookup&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help