GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  NET::GOOGLE::SAFEBROWSING2::LOOKUP (3)

.ds Aq ’

NAME

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

CONTENTS

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.

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 NET::GOOGLE::SAFEBROWSING2::LOOKUP (3) 2013-06-06

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.