Hack 50-59

HACK#59 การเขียนโปรแกรม Google Web API ด้วย VB.NET

2007-08-08T15:38:00.000+07:00

สร้าง Google Search Application แบบ GUI ด้วย Visual Basic และ .NET Framework

นอกจากที่มีตัวอย่างในการพัฒนา Google Search Application ด้วย C# [Hack #58] แล้ว Google Web APIs Developer’s Kit ได้มีตัวอย่างของ Google Search ใน Visual Basic รวมเอาไว้อยู่ด้วยเช่นกัน ในขณะที่คุณอาจจะผสมผเสรวบรวมสิ่งต่างๆที่จำเป็นเกือบจะทั้งหมดจาก Google Demo Form.vb ซึ่งเป็นโค้ดที่มีมาให้อยู่ในชุด kit ดังกล่าวอยู่แล้ว การแฮ็กในหัวข้อนี้ก็ได้เตรียมโค้ดพื้นฐานอันเป็นเบื้องต้นสำหรับ Google Search Application โดยปราศจากข้อกังขาในการพัฒนาถึงขั้นความสามารถอันเต็มพิกัดของโปรเจ็ค Visual Studio .NET

Tip: การคอมไพล์และรันการแฮ็กนี้จำเป็นต้องมี .NET Framework (http://msdn.microsoft.com/library/default.asp?url=/nhp/default.asp?contentid=28000519) ติดตั้งอยู่ด้วย

โค้ดตัวอย่าง

' googly.vb

' A Google Web API VB.NET console application

' Usage: googly.exe

' No warranties extended. Use at your own risk.

Imports System

Module Googly

Sub Main(ByVal args As String( ))

' Your Google API developer's key

Dim googleKey As String = "insert key here"

' Take the query from the command-line

If args.Length <> 1 Then

Console.WriteLine("Usage: google.exe ")

Return

End If

Dim query As String = args(0)

' Create a Google SOAP client proxy, generated by:

' c:\> wsdl.exe /l:vb http://api.google.com/GoogleSearch.wsdl

Dim googleSearch As GoogleSearchService = New GoogleSearchService( )

' Query Google

Dim results As GoogleSearchResult = googleSearch.doGoogleSearch(googleKey, query, 0, 10, False, "", False, "", "latin1", "latin1")

' No results?

If results.resultElements Is Nothing Then Return

' Loop through results

Dim result As ResultElement

For Each result In results.resultElements

Console.WriteLine( )

Console.WriteLine(result.title)

Console.WriteLine(result.URL)

Console.WriteLine(result.snippet)

Console.WriteLine( )

End Sub

End Module

โปรดอย่าลืมใส่ Google Developer Key (เช่น 12BuCK13mY5h0E/34KNocK@ttH3DoOR)

ของคุณลงใน “insert key here”

‘Your Google API developer’s key

Dim googleKey As String = “12BuCK13mY5h0E/34KNocK@ttH3DoOR”

การคอมไพล์โค้ด

ก่อนที่จะคอมไพล์โค้ด VB Application ได้นั้น คุณจะต้องสร้าง Google SOAP Client Proxy เสียก่อน ซึ่ง Google SOAP Client Proxy นี้จะเป็นโค้ดจำนวนหนึ่งที่สร้างตามรายละเอียด (specification) ในไฟล์ GoogleSearch.wsdl ซึ่งจะประกอบด้วย XML based description เกี่ยวกับ Google Web Service, mothod, parameter, และ return value แต่นับว่าโชคดีที่ .NET Framework kit ที่มีมาให้นั้น มีไฟล์ wsdl.exe ซึ่งทำให้คุณไม่ต้องมาเขียนโค้ดด้วยตัวคุณเอง

Tip: นี่อาจเป็นสิ่งที่แปลกสักหน่อยหากคุณได้ลองนึกดู เนื่องจากส่วนสำคัญในการเชื่อมต่อกับ Web Service กลับถูกสร้างขึ้นจาก description ของมันเองโดยอัตโนมัติ

เรียกไฟล์ wsdl.exe จากไดเรกทอรีที่ GoogleSearch.wsdl อยู่ ดังนี้

C:\GOOGLY.NET>wsdl.exe /l:vb GoogleSearch.wsdl

คุณอาจจะระบุถึงไฟล์ wsdl.exe ที่อยู่ในเว็บไซต์ของ Google ก็ได้เช่นกัน

C:\GOOGLY.NET\VB>wsdl.exe /l:vb http://api.google.com/GoogleSearch.wsdl

Microsoft (R) Web Services Description Language Utility

[Microsoft (R) .NET Framework, Version 1.0.3705.0]

Writing file 'C:\GOOGLY.NET\VB\GoogleSearchService.vb'.

ผลลัพธ์ที่คุณจะได้รับไฟล์ GoogleSearchService.vb นั้นจะมีหน้าตาลักษณะนี้

'---------------------------------------------------------------------------

' <autogenerated>

' This code was generated by a tool.

' Runtime Version: 1.0.3705.288

' Changes to this file may cause incorrect behavior and will be lost if

' the code is regenerated.

' </autogenerated>

'---------------------------------------------------------------------------

Option Strict Off

Option Explicit On

Imports System

Imports System.ComponentModel

Imports System.Diagnostics

Imports System.Web.Services

Imports System.Web.Services.Protocols

Imports System.Xml.Serialization

...

Public Function BegindoGoogleSearch(ByVal key As String, ByVal q As

String, ByVal start As Integer, ByVal maxResults As Integer, ByVal

filter As Boolean, ByVal restrict As String, ByVal safeSearch As

Boolean, ByVal lr As String, ByVal ie As String, ByVal oe As String,

ByVal callback As System.AsyncCallback, ByVal asyncState As Object) As

System.IAsyncResult

Return Me.BeginInvoke("doGoogleSearch", New Object( ) {key, q,

start, maxResults, filter, restrict, safeSearch, lr, ie, oe}, callback,

asyncState) End Function

'<remarks/>

Public Function EnddoGoogleSearch(ByVal asyncResult As System.IAsyncResult) As GoogleSearchResult

Dim results( ) As Object = Me.EndInvoke(asyncResult)

Return CType(results(0),GoogleSearchResult)

End Function

End Class

สำหรับการคอมไพล์ไฟล์ googly.vb

C:\GOOGLY.NET\VB>vbc /out:googly.exe *.vb

Microsoft (R) Visual Basic .NET Compiler version 7.00.9466

for Microsoft (R) .NET Framework version 1.00.3705

Running the Hack

รัน Googly ที่ command line โดยการใส่คำถามที่ต้องการเข้าไปแทนที่ query word

C:\GOOGLY.NET\VB>googly.exe “query words”

Tip: หน้าต่างของ dos command อาจจะไม่กว้างพอสำหรับการแสดงผล ซึ่งคุณสามารถแก้ปัญหาได้โดยการส่งผลลัพธ์ที่ได้จากการค้นหาไปยังไฟล์อื่นใด เพื่อใช้เอดิเตอร์ (editor) ตรวจดูผลลัพธ์ได้ ซึ่งการส่งผลลัพธ์ไปยังไฟล์ดังกล่าวทำได้โดย เพิ่ม > results.txt ต่อท้ายเข้าไปที่คำสั่งข้างต้น

ผลลัพธ์

ขั้นตอนต่างๆของการแฮ็กในหัวข้อนี้จะเหมือนกับในส่วนของ C# [Hack #58] และตามปกติเมื่อสั่งรันแล้วก็ควรจะได้ผลลัพธ์เหมือนๆกันด้วยเช่นกัน

HACK#58 การโปรแกรม Google Web API ด้วย C# และ .NET

2007-08-08T14:57:00.000+07:00

สร้าง Google Search Application แบบ GUI ด้วย C# และ .NET framework

ใน Google Web API Developer’s Kit [ดู “The Google Web APIs Developer’s Kit”] มีตัวอย่างของ C# Visual Studio .NET (http://msdn.microsoft.com/vstudio) ซึ่งเป็น project ทางด้าน GUI Google Search Application (ดูในโฟลเดอร์ dotnet/cSharp) ซึ่งส่วนที่น่าสนใจที่สุดน่าจะเป็นโค้ดในไฟล์ Form1.cs

การแฮ็กในหัวข้อนี้จะเป็นการเตรียมโค้ดเบื้องต้นสำหรับ Google Search Application ซึ่งจะคล้ายๆกับการทำงานใน Perl [Hack #50], Java [Hack #56] และ Python [Hack #57]

Tip:การคอมไพล์และรันการแฮ็กนี้จำเป็นต้องมี .NET Framework (http://msdn.microsoft.com/library/default.asp?url=/nhp/default.asp?contentid=28000519) ติดตั้งในเครื่องของคุณอยู่ด้วย

โค้ดตัวอย่าง

// googly.cs

// A Google Web API C# console application

// Usage: googly.exe

// No warranties extended. Use at your own risk.

using System;

class Googly {

static void Main(string[] args) {

// Your Google API developer's key

string googleKey = "insert key here";

// Take the query from the command-line

if( args.Length != 1 ) {

Console.WriteLine("Usage: google.exe ");

return;

}

string query = args[0];

// Create a Google SOAP client proxy, generated by:

// c:\> wsdl.exe http://api.google.com/GoogleSearch.wsdl

GoogleSearchService googleSearch = new GoogleSearchService( );

// Query Google

GoogleSearchResult results = googleSearch.doGoogleSearch(googleKey, query, 0, 10, false, "", false, "", "latin1", "latin1");

// No results?

if( results.resultElements == null ) return;

// Loop through results

foreach( ResultElement result in results.resultElements ) {

Console.WriteLine( );

Console.WriteLine(result.title);

Console.WriteLine(result.URL);

Console.WriteLine(result.snippet);

Console.WriteLine( );

}

อย่าลืมใส่ Google Developer’s key [ดู “Using the key in the hack”] (เช่น 12BuCK13mY5h0E/34KNocK@ttH3DoOR) ของคุณลงไปแทนใน “insert key here”

//Your Google API developer’s key

string googleKey = “12BuCK13mY5h0E/34KNocK@ttH3DoOR”;

การคอมไพล์โค้ด

ก่อนที่จะคอมไพล์โค้ด C# ได้นั้น คุณจะต้องสร้าง Google SOAP Client Proxy เสียก่อน ซึ่ง Google SOAP Client Proxy นี้จะเป็นโค้ดจำนวนหนึ่งที่สร้างตาม specification ในไฟล์ GoogleSearch.wsdl ซึ่งจะประกอบด้วย XML based description เกี่ยวกับ Google Web Service, mothod ทั้งหมดของมัน และ parameter ต่างๆ รวมถึง return value ด้วย แต่นับว่าโชคดีที่ .NET Framework Kit ที่มีมาให้ มีไฟล์ wsdl.exe ซึ่งทำให้คุณไม่ต้องมานั่งเขียนโค้ดด้วยตัวคุณเอง

Tip: สิ่งที่น่าสนใจในเรื่องนี้ก็คือ ส่วนสำคัญในการอินเทอร์เฟสกับ web service ที่ถูกสร้างขึ้นจาก description ของมันเอง

เรียกไฟล์ wsdl.exe จากไดเรกทอรีที่ GoogleSearch.wsdl อยู่ ดังนี้

C:\GOOGLY.NET>wsdl.exe GoogleSearch.wsdl

คุณอาจจะระบุถึงไฟล์ wsdl.exe ที่อยู่ในเว็บไซต์ของ Google ก็ได้เช่นกัน

C:\GOOGLY.NET\CS>wsdl.exe http://api.google.com/GoogleSearch.wsdl

Microsoft (R) Web Services Description Language Utility

[Microsoft (R) .NET Framework, Version 1.0.3705.0]

Writing file 'C:\GOOGLY.NET\CS\GoogleSearchService.cs'.

ผลลัพธ์รายการสุดท้าย ซึ่งก็คือไฟล์ GoogleSearchService.cs จะมีหน้าตาลักษณะนี้

//--------------------------------------------------------------------------

// <autogenerated>

// This code was generated by a tool.

// Runtime Version: 1.0.3705.288

// Changes to this file may cause incorrect behavior and will be lost if

// the code is regenerated.

// </autogenerated>

//--------------------------------------------------------------------------

// This source code was auto-generated by wsdl, Version=1.0.3705.288.

using System.Diagnostics;

using System.Xml.Serialization;

using System;

using System.Web.Services.Protocols;

using System.ComponentModel;

using System.Web.Services;

...

public System.IAsyncResult BegindoGoogleSearch(string key,

string q, int start, int maxResults, bool filter, string restrict,

bool safeSearch, string lr, string ie, string oe,

System.AsyncCallback callback, object asyncState) {

return this.BeginInvoke("doGoogleSearch", new object[] {

key,

start,

maxResults,

filter,

restrict,

safeSearch,

lr,

ie,

oe}, callback, asyncState);

}

สำหรับไฟล์ googly.cs

C:\GOOGLY.NET\CS>csc /out:googly.exe *.cs

Microsoft (R) Visual C# .NET Compiler version 7.00.9466

for Microsoft (R) .NET Framework version 1.0.3705

Running the Hack

รัน Googly ที่ command line โดยการใส่คำถามที่ต้องการเข้าไปแทนที่ “query word”

C:\GOOGLY.NET\CS>googly.exe “query words”

Tip: หน้าต่างของ dos command อาจจะไม่กว้างพอสำหรับการแสดงผล ซึ่งคุณสามารถแก้ปัญหาได้โดยการส่งผลลัพธ์ที่ได้จากการค้นหาไปยังไฟล์อื่นใด เพื่อใช้เอดิเตอร์ (editor) ในการตรวจดูผลลัพธ์ก่อน ซึ่งการส่งผลลัพธ์ไปยังไฟล์ดังกล่าวทำได้โดย เพิ่ม > results.txt ต่อท้ายเข้าไปที่คำสั่ง

ผลลัพธ์

  % googly.exe "WSDL while you work"
  Axis/Radio interop, actual and potential
  http://www.intertwingly.net/stories/2002/02/08/
  axisradioInteropActualAndPotential.html <b>...</b> But
  <b>you</b> might find more exciting services here
  <b>...</b> Instead, we should <b>work</b>
  together and<br> continuously strive to <b>...</b>
  <b>While</b> <b>WSDL</b> is certainly far from
  perfect and has many <b>...</b>  
  ...
  Simplified <b>WSDL</b>
  http://capescience.capeclear.com/articles/simplifiedWSDL/
  <b>...</b> So how does it <b>work</b>?
  <b>...</b> If <b>you</b> would like to edit
  <b>WSDL</b> <b>while</b> still avoiding<br> all
  those XML tags, check out the <b>WSDL</b> Editor in
  CapeStudio. <b>...</b>

HACK#57 การเขียนโปรแกรม Google Web API ด้วย Python

2007-08-08T14:48:00.000+07:00

การโปรแกรม Google Web API ด้วย Python นี้ค่อนข้างง่าย ลองดูไปตามที่สคริปต์และตัวอย่างนี้ได้สาธิตเอาไว้

การเขียนโปรแกรม Google Web API ด้วย Python เป็นสิ่งที่ง่ายเป็นอย่างมาก และต้องขอขอบคุณ PyGoogle wrapper module ของ Mark Pilgrim (http://diveintomark.org/projects/pygoogle/) ซึ่งได้เตรียมสิ่งต่างๆสำหรับรองรับ SOAP, XML และ request/response layer ช่วยให้คุณมีเวลาเหลือสำหรับศึกษาข้อมูลจากสิ่งเหล่านั้นมากขึ้น

การติดตั้ง PyGoogle

ให้ดาวน์โหลด PyGoogle มา แล้วทำตามคำแนะนำในไฟล์ readme.txt (http://diveintomark.org/projects/pygoogle/readme.txt) ซึ่งถ้าไม่ติดขัดประการใด การติดตั้งไม่น่าจะยุ่งยากไปกว่าเพียงแค่ใช้คำสั่ง

% python setup.py install

อีกวิธีหนึ่ง ถ้าคุณต้องการไปอย่างรวดเร็วและไม่ต้องการติดตั้ง PyGoogle หรือต้องการติดตั้งแต่ไม่ได้รับอนุญาต(Permission) ในการติดตั้งในระบบของคุณ คุณก็เพียงแต่บันทึกไฟล์ SOAP.py และ google.py ลงไปในไดเรกทอรีเดียวกันเท่านั้น

โค้ดตัวอย่าง

#!/usr/bin/python

# googly.py

# A typical Google Web API Python script using Mark Pilgrim's

# PyGoogle Google Web API wrapper

# [http://diveintomark.org/projects/pygoogle/]

# Usage: python googly.py

import sys, string, codecs

# Use the PyGoogle module

import google

# Grab the query from the command-line

if sys.argv[1:]:

query = sys.argv[1]

else:

sys.exit('Usage: python googly.py ')

# Your Google API developer's key

google.LICENSE_KEY = 'insert key here'

# Query Google

data = google.doGoogleSearch(query)

# Teach standard output to deal with utf-8 encoding in the results

sys.stdout = codecs.lookup('utf-8')[-1](sys.stdout)

# Output

for result in data.results:

print string.join( (result.title, result.URL, result.snippet), "\n"), "\n"

Running the Hack

สั่งสคริปต์ให้ทำงานที่ command line ด้วยคำสั่งดังนี้

% python googly.py "query words"

ผลลัพธ์

% python googly.py "learning python"

oreilly.com -- Online Catalog: Learning

Python

http://www.oreilly.com/catalog/lpython/

Learning Python is an

introduction to the increasingly popular interpreted programming

language that's portable, powerful, and remarkably easy to use in both

...

...

Book Review: Learning Python

http://www2.linuxjournal.com/lj-issues/issue66/3541.html

... Issue 66: Book Review: Learning

Python ... Enter

Learning Python. My executive summary

is that this is the right book for me and probably for many others

as well. ...

Hacking the Hack

Python มีความสามารถในการเชื่อมต่อการทำงานแบบ Interactive ร่วมกับตัวแปลภาษา (Interpreter) ได้อย่างดีเยี่ยม ซึ่งเป็นที่ที่ดีในการทดลองกับโมดูลต่างๆอย่างเช่น PyGoogle เป็นต้น ซึ่งจะทำให้การส่งค่า Google Web API อย่างรวดเร็ว รวมทั้งค้นหาตลอดโครงสร้างข้อมูล (Data Structure) ที่ได้รับมา

ข้างล่างนี้คือตัวอย่างแบบ Interactive ของ PyGoogle Session ซึ่งใช้ฟังก์ชัน doGoogleSearch, deGetCatchedPage และ doSpellingSuggestion ในการทำงาน

  % python
  Python 2.2 (#1, 07/14/02, 23:25:09) 
  [GCC Apple cpp-precomp 6.14] on darwin
  Type "help", "copyright", "credits" or "license" for more information.
  >>> import google
  >>> google.LICENSE_KEY = 'insert key here'
  >>> data = google.doGoogleSearch("Learning Python")
  >>> dir(data.meta)
  ['_  _doc_  _', '_  _init_  _', '_  _module_  _', 'directoryCategories', 
  'documentFiltering', 'endIndex', 'estimateIsExact', 
  'estimatedTotalResultsCount', 'searchComments', 'searchQuery', 
  'searchTime', 'searchTips', 'startIndex']
  >>> data.meta.estimatedTotalResultsCount
  115000
  >>> data.meta.directoryCategories
  [{u'specialEncoding': '', u'fullViewableName': "Top/Business/Industries/
  Publishing/Publishers/Nonfiction/Business/O'Reilly_and_Associates/
  Technical_Books/Python"}]
  >>> dir(data.results[5])
  ['URL', '_  _doc_  _', '_  _init_  _', '_  _module_  _', 'cachedSize', 
  'directoryCategory', 'directoryTitle', 'hostName', 
  'relatedInformationPresent', 'snippet', 'summary', 'title']
  >>> data.results[0].title
  'oreilly.com -- Online Catalog: <b>Learning</b> <b>Python'
  >>> data.results[0].URL
  'http://www.oreilly.com/catalog/lpython/'
  >>> google.doGetCachedPage(data.results[0].URL)
  '<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">\n
  <BASE HREF="http://www.oreilly.com/catalog/lpython/"><table border=1
  ...
  >>> google.doSpellingSuggestion('lurn piethon')
  'learn python'

HACK#56 การโปรแกรม Google Web API ด้วย Java

2007-08-08T14:42:00.001+07:00

การโปรแกรม Google Web API ในจาวานั้นสามารถทำใด้อย่างรวดเร็ว เนื่องจากมีไลบรารี่ให้มาพร้อมกับ Google Web API Developer’s Kit อยู่แล้ว

ต้องขอขอบคุณ Java Archive (JAR) ซึ่งมีมาให้พร้อมกับ Google Web API Developer’s Kit [ใน “The Google Web APIs Developer’s Kit”] ซึ่งใน googleapi.jar archive ได้รวมเอา com.google.soap.search ซึ่งเป็น wrapper ที่ดีมากมาให้ด้วย พร้อมทั้ง Crimson XML parser (http://xml.apache.org/crimson) ของ Apache Software Foundation และตัวสุดท้ายที่มาพร้อมกันก็คือ Apache SOAP stack (http://xml.apache.org/soap)

Tip:คุณอาจจำเป็นต้องใช้ copy ของ Java 2 Platform, Standard Edition (J2SE, http://java.sun.com/downloads/) ในการคอมไพล์และรันการแฮ็กด้วยวิธีนี้

โค้ดตัวอย่าง

// Googly.java

// Bring in the Google SOAP wrapper

import com.google.soap.search.*;

import java.io.*;

public class Googly {

// Your Google API developer's key

private static String googleKey = "insert key here";

public static void main(String[] args) {

// Make sure there's a Google query on the command-line

if (args.length != 1) {

System.err.println("Usage: java [-classpath classpath] Googly ");

System.exit(1);

}

// Create a new GoogleSearch object

GoogleSearch s = new GoogleSearch( );

try {

s.setKey(googleKey);

s.setQueryString(args[0]); // Google query from the command-line

s.setMaxResults(10);

// Query Google

GoogleSearchResult r = s.doSearch( );

// Gather the results

GoogleSearchResultElement[] re = r.getResultElements( );

// Output

for ( int i = 0; i <>

System.out.println(re[i].getTitle( ));

System.out.println(re[i].getURL( ));

System.out.println(re[i].getSnippet( ) + "\n");

}

// Anything go wrong?

} catch (GoogleSearchFault f) {

System.out.println("GoogleSearchFault: " + f.toString( ));

}

โปรดอย่าลืมใส่ Google Developer Key (เช่น 12BuCK13mY5h0E/34KNocK@ttH3DoOR) ของคุณลงไปแทนใน “insert key here”

//Your Google API developer’s key

private static String googleKey = “12BuCK13mY5h0E/34KNocK@ttH3DoOR”;

การคอมไพล์โค้ด

สำหรับการคอมไพล์ Googly application (Googly.java) คุณจำเป็นต้องมี googleapi.jar archive ก่อน สำหรับผู้เขียนได้เก็บเอาไว้ในไดเรกทอรีเดียวกับ googly.java แต่ถ้าหากคุณเก็บไว้ในที่อื่น ให้เปลี่ยนพาธหลัง –classpath ไปตามนั้น

% javac -classpath googleapi.jar Googly.java

ด้วยวิธีนี้คุณจะได้ไฟล์ Googly.class ใหม่ ซึ่งพร้อมที่จะทำงานได้แล้ว

Running the Hack

รัน Googly ที่ command line โดยการใส่คำถามที่ต้องการลงไปแทนที่ “query word”

% java -classpath .:googleapi.jar Googly "query words"

ผลลัพธ์

% java -classpath .:googleapi.jar Googly "Learning Java"

oreilly.com -- Online Catalog: Learning Java

http://www.oreilly.com/catalog/learnjava/

For programmers either just migrating to Java or already working

steadily in the forefront of Java development, Learning Java gives

a clear, systematic ...

oreilly.com -- Online Catalog: Learning Java , 2nd Edition

http://www.oreilly.com/catalog/learnjava2/

This new edition of Learning Java has been expanded and updated for

Java 2 Standard Edition SDK 1.4. It comprehensively addresses ...

...

Java Programming...From the Grounds Up / Web Developer

http://www.webdeveloper.com/java/java_programming_grounds_up.html

... WebDeveloper.com. Java Programming... From the Grounds Up. by

Mark C. Reynolds ... Java Classes and Methods. Java utilizes the

basic object technology found in C++. ...

HACK#55 การเขียนโปรแกรม Google Web API ด้วย PHP

2007-08-08T14:39:00.000+07:00

ตัวอย่างง่ายๆในการโปรแกรม Google Web API ด้วย PHP และโมดูล NuSOAP

PHP (http://www.php.net) ซึ่งย่อมาจาก “PHP Hypertext Processing” เป็นภาษาสคริปต์ที่ใช้งานร่วมกับ HTML และได้รับการยอมรับเป็นอย่างมาก ในการพัฒนาโปรแกรมทางด้านเว็บ และสำหรับการเพิ่มโมดูลของ PHP ที่ชื่อ NuSOAP เข้าไป (http://dietrich.ganx4.com/nusoap) จะทำให้สามารถสร้างและใช้งาน SOAP based web service ได้

การแฮ็กในหัวข้อนี้ จะแสดงให้เห็นการใช้งาน PHP และ NuSOAP ในการทำงานร่วมกับ Google Web API

โค้ดตัวอย่าง

<!--

# googly.php

# A typical Google Web API php script

# Usage: googly.php?query=<query>

-->

<html>

<head>

<title>googly.php</title>

</head>

<body>

# Use the NuSOAP php library

require_once('nusoap.php');

# Set parameters

$parameters = array(

'key'=>'insert key here',

'q' => $HTTP_GET_VARS['query'],

'start' => '0',

'maxResults' => '10',

'filter' => 'false',

'restrict' => '',

'safeSearch' => 'false',

'lr' => '',

'ie' => 'latin',

'oe' => 'latin'

);

# Create a new SOAP client, feeding it GoogleSearch.wsdl on Google's site

$soapclient = new soapclient('http://api.google.com/GoogleSearch.wsdl', 'wsdl');

# query Google

$results = $soapclient->call('doGoogleSearch',$parameters);

# Results?

if ( is_array($results['resultElements']) ) {

print "Your Google query for '" . $HTTP_GET_VARS['query'] . "' found " . $results['estimatedTotalResultsCount'] . " results, the top ten of which are:";

foreach ( $results['resultElements'] as $result ) {

"<a href='" . $result['URL'] . "'>" .

( $result['title'] ? $result['title'] : 'no title' ) .

"</a> " . $result['URL'] . " " .

( $result['snippet'] ? $result['snippet'] : 'no snippet' ) .

"";

}

# No Results

else {

print "Your Google query for '" . $HTTP_GET_VARS['query'] . "' returned no results";

}

</body>

</html>

Running the Hack

ดำเนินการแฮ็กด้วยวิธีการเดียวกันกับที่คุณทำในการเรียกใช้ CGI Script ทั่วไป โดยให้คุณใส่คำถาม (query) ที่ต้องการลงไปแทน your google query

http://localhost/googly.php?query=your google query

ผลลัพธ์

จากภาพที่ 5-1 เป็นการค้นหาด้วยคำว่า php

รูปที่ 5-1 ผลลัพธ์จากการค้นหาโดยใช้คำว่า PHP

HACK#54 NoXML อีกทางเลือกหนึ่งสำหรับใช้แทน SOAP::Lite

2007-08-08T14:29:00.000+07:00

NoXML เป็นทางเลือกในการใช้แทน SOAP::Lite ซึ่งใช้เพียง regular expression ทำงาน โดยไม่ต้องมี XML parser แต่อย่างใด

NoXML เป็นอีกโมดูลหนึ่ง ที่ใช้แทน SOAP::Lite ได้ ซึ่ง NOXML นี้จะใช้เพียง regular expression ทำงาน โดยปราศจาก XML parser ทุกชนิด ดังที่ชื่อของโมดูลนี้ได้แนะนำไว้

ถ้าหากคุณมีเพียงความรู้พื้นฐานในการติดตั้ง Perl เพื่อใช้งานของคุณเองเท่านั้น รวมทั้งไม่มีทั้ง SOAP::Lite [Hack #52] และ XML::Parser แล้วล่ะก็ NoXML นับเป็นทางเลือกที่ดีทีเดียวสำหรับการแฮ็กเกือบจะทั้งหมดในหนังสือเล่มนี้

Tip: ผู้เชี่ยวชาญ XML บางท่านยืนยันว่า ไม่มีอะไรมาแทนที่ XML parser จริงๆได้ ซึ่งเป็นสิ่งที่ถูกต้องอย่างยิ่ง เพราะยังมีประเด็นเรื่องการ Encode และ Hierarchy ที่ regular expression-based parser ไม่สามารถทำได้ แต่สำหรับตัว NOXML นั้นก็ยังเป็นตัวที่ง่ายที่สุดสำหรับการใช้งานและติดตั้ง

NoXML สามารถใช้แทน SOAP::Lite โดยการแก้ไขสคริปต์ที่ใช้ในการแฮ็กเพียงเล็กน้อยเท่านั้น

โค้ดของ NoXML

ไฟล์สำคัญในการแฮ็กในหัวข้อนี้ก็คือ NoXML.pm ซึ่งควรจะบันทึกลงในไดเรกทอรีเดียวกันกับสคริปต์ที่ใช้ในการแฮ็ก

# NoXML.pm

# NoXML [pronounced "no xml"] is a dire-need drop-in

# replacement for SOAP::Lite designed for Google Web API hacking.

package NoXML;

use strict;

no strict "refs";

# LWP for making HTTP requests, XML for parsing Google SOAP

use LWP::UserAgent;

use XML::Simple;

# Create a new NoXML

sub new {

my $self = {};

bless($self);

return $self;

}

# Replacement for the SOAP::Lite-based doGoogleSearch method

sub doGoogleSearch {

my($self, %args);

($self, @args{qw/ key q start maxResults filter restrict

safeSearch lr ie oe /}) = @_;

# grab SOAP request from _ _DATA_ _

my $tell = tell(DATA);

my $soap_request = join '', ;

seek(DATA, $tell, 0);

$soap_request =~ s/\$(\w+)/$args{$1}/ge; #interpolate variables

# Make (POST) a SOAP-based request to Google

my $ua = LWP::UserAgent->new;

my $req = HTTP::Request->new(POST => 'http://api.google.com/search/beta2');

$req->content_type('text/xml');

$req->content($soap_request);

my $res = $ua->request($req);

my $soap_response = $res->as_string;

# Drop the HTTP headers and so forth until the initial xml element

$soap_response =~ s/^.+?(<\?xml)/$1/migs;

# Drop element namespaces for tolerance of future prefix changes

$soap_response =~ s!(<\/?)[\w-]+?:([\w-]+?)!$1$2!g;

# Set up a return dataset

my $return;

# Unescape escaped HTML in the resultset

my %unescape = ('<'=>'<', '>'=>'>', '&'=>'&amp;', '"'=>'"', '''=>"'");

my $unescape_re = join '|' => keys %unescape;

# Divide the SOAP response into the results and other metadata

my($before, $results, $after) = $soap_response =~

m#(^.+)(.+?)(.+$)#migs ;

my $before_and_after = $before . $after;

# Glean as much metadata as possible (while being somewhat lazy ;-)

while ($before_and_after =~ m#([^<]*?)<#migs) {

$return->{$1} = $3; # pack the metadata into the return dataset

}

# Glean the results

my @results;

while ($results =~ m#(.+?)#migs) {

my $item = $1;

my $pairs = {};

while ( $item =~ m#([^<]*)#migs ) {

my($element, $value) = ($1, $2);

$value =~ s/($unescape_re)/$unescape{$1}/g;

$pairs->{$element} = $value;

}

push @results, $pairs;

}

# Pack the results into the return dataset

$return->{resultElements} = \@results;

# Return nice, clean, usable results

return $return;

}

# This is the SOAP message template sent to api.google.com. Variables

# signified with $variablename are replaced by the values of their

# counterparts sent to the doGoogleSearch subroutine.

_ _DATA_ _

<?xml version='1.0' encoding='UTF-8'?>

<SOAP-ENV:Envelope

xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:xsi="http://www.w3.org/1999/XMLSchema-instance"

xmlns:xsd="http://www.w3.org/1999/XMLSchema">

<SOAP-ENV:Body>

<ns1:doGoogleSearch xmlns:ns1="urn:GoogleSearch"

SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">

<start xsi:type="xsd:int">$start</start>

<maxResults xsi:type="xsd:int">$maxResults</maxResults>

<filter xsi:type="xsd:boolean">$filter</filter>

<restrict xsi:type="xsd:string">$restrict</restrict>

<safeSearch xsi:type="xsd:boolean">$safeSearch</safeSearch>

</ns1:doGoogleSearch>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

ข้างล่างนี้เป็นตัวอย่างสคริปต์ NoXML ในแง่การใช้งาน ซึ่งก็ไม่แตกต่างอะไรไปจากการแฮ็กในหัวข้ออื่นๆในหนังสือเล่มนี้ จะมีก็เพียงแต่การเน้นข้อความเป็นตัวหนา (bold) ตรงส่วนที่มีการ comment บรรทัดเดิมที่ใช้กับ SOAP::Lite และแทรกบรรทัดใหม่ เพื่อให้ใช้กับ PoXML ได้เท่านั้น

#!/usr/bin/perl

# noxml_google2csv.pl

# Google Web Search Results via NoXML ("no xml") module

# exported to CSV suitable for import into Excel

# Usage: noxml_google2csv.pl "{query}" [> results.csv]

# Your Google API developer's key

my $google_key='insert key here';

use strict;

# use SOAP::Lite;

use NoXML;

$ARGV[0]

or die qq{usage: perl noxml_search2csv.pl "{query}"\n};

# my $google_search = SOAP::Lite->service("file:$google_wdsl");

my $google_search = new NoXML;

my $results = $google_search ->

doGoogleSearch(

$google_key, shift @ARGV, 0, 10, "false",

"", "false", "", "latin1", "latin1"

);

@{$results->{'resultElements'}} or die('No results');

print qq{"title","url","snippet"\n};

foreach (@{$results->{'resultElements'}}) {

$_->{title} =~ s!"!""!g; # double escape " marks

$_->{snippet} =~ s!"!""!g;

my $output = qq{"$_->{title}","$_->{URL}","$_->{snippet}"\n};

$output =~ s!<.+?>!!g; # drop all HTML tags

print $output;

}

Running the Hack

รันสคริปต์นี้ที่ command line โดยการใส่คำถามลงไปที่ command line และระบุให้แสดงผลลัพธ์ในไฟล์ CSV ที่คุณต้องการสร้างขึ้นมา หรือที่ต้องการให้นำผลลัพธ์ไปต่อท้าย (appending) ตัวอย่างเช่นข้างล่างนี้ใช้ “no xml” เป็นคำถาม และกำหนดให้ไฟล์ results.csv เป็นไฟล์รับผลลัพธ์ที่ได้กลับคืนมา

$ perl noxml_google2csv.pl "no xml" > results.csv

หรือจะตัดส่วนของ > และ results.csv ออก เพื่อส่งผลลัพธ์ให้ไปแสดงที่หน้าจอเพื่อตรวจสอบก่อนก็ได้ และเห็นผลลัพธ์ทันที

ผลลัพธ์

% perl noxml_google2csv.pl "no xml"

"title","url","snippet"

"site-comments@w3.org from January 2002: No XML specifications",

"http://lists.w3.org/Archives/Public/site-comments/2002Jan/0015.html",

"No XML specifications. From: Prof. ... Next message: Ian B. Jacobs:

"Re: No XML specifications"; Previous message: Rob Cummings:

"Website design..."; ... "

...

"Re: [xml] XPath with no XML Doc",

"http://mail.gnome.org/archives/xml/2002-March/msg00194.html",

" ... Re: [xml] XPath with no XML Doc. From: "Richard Jinks"

; To: ; Subject:

Re: [xml] XPath with no XML Doc; ... "

การใช้งานและข้อจำกัด

ด้วยวิธีเดียวกันนี้ คุณสามารถดัดแปลงวิธีการแฮ็กด้วย SOAP::Lite ที่ได้อธิบายไว้ในหัวข้อต่างๆ ตลอดหนังสือเล่มนี้ มาเป็นการใช้ PoXML ในการแฮ็กแทนก็ได้ โดยมีข้อกำหนดดังนี้

วางไฟล์ NoXML.pm ไว้ในไดเรกทอรีเดียวกันกับสคริปต์ของเรื่องที่จะแฮ็ก
แทนที่บรรทัดในสคริปต์ที่เป็น use SOAP::Lite; ด้วย use NoXML;
แทนที่ my $google_search = SOAP::Lite->service(“file:$google_wdsl”); ด้วย my $google_search = new NoXML;

อย่างไรก็ตาม ยังมีข้อจำกัดในการใช้งานอยู่บ้าง ในขณะที่ NoXML ทำงานได้ดีในการดึงผลลัพธ์รวมทั้งสรุปผลลัพธ์ที่ได้จากการค้นหา แต่ก็ไม่ประสบผลสำเร็จในด้านการรวบรวมผลลัพธ์ในขั้นละเอียดขึ้น (advanced result) บางอย่าง เช่น <directoryCategories> เป็นต้น

ดูเพิ่มเติม

PoXML [Hack #53] เป็นทางเลือกในการใช้ plain old XML แทน SOAP::Lite

XooMLE [Hack #36] เป็น third-party service ซึ่งเป็นตัวกลาในการ interface ระหว่าง Plain Old XML กับ Google Web API

HACK#53 Plain Old XML

2007-08-08T14:21:00.000+07:00

PoXML เป็นโมดูลที่สามารถใช้แทน SOAP::Lite ในกรณีที่ไม่สามารถติดตั้ง SOAP::Lite ได้

PoXML นับเป็นทางเลือกทางหนึ่งสำหรับท่านที่ไม่สามารถใช้ SOAP::Lite [Hack #52] ได้ ซึ่งอาจจะเป็นด้วยเพราะการติดตั้งที่ยุ่งยากหรืออะไรก็ตามแต่

Tip: ผู้รู้เกี่ยวกับ Perl ยืนยันว่าการติดตั้งโมดูลนี้มีขั้นตอนที่ง่ายมาก อย่างไรก็ตาม หลายๆคนแย้งว่า การติดตั้งไม่ได้ง่ายดายอย่างที่กล่าวเอาไว้นัก

PoXML นั้นสามารถใช้แทน SOAP::Lite ได้ในระดับที่ดีพอใช้ โดยการที่ทำงานร่วมกับ SOAP ของ Google ตามแบบ Plain Old XML โดยการใช้ LWP::UserAgent ในการสร้าง HTTP request และใช้ XML::Simple ในการประมวลผล XML แต่ส่วนที่เป็นข้อดีที่สุดก็คือ มีการแก้ไขสคริปต์เพียง 2 บรรทัดเท่านั้น เมื่อมีการใช้งานแทน SOAP::Lite ในการแฮ็กเป้าหมายต่างๆในหนังสือเล่มนี้

โค้ดของ PoXML

ไฟล์สำคัญที่ใช้ในหัวข้อนี้ก็คือไฟล์ PoXML.pm ซึ่งเป็นเพิร์ลโมดูลเล็กๆที่เหมาะสมที่จะบันทึกเก็บไว้ในไดเรกทอรีเดียวกันกับสคริปต์ที่ใช้ในการแฮ็ก

ประมวลผล XML แต่ส่วนที่เป็นข้อดีที่สุดก็คือ มีการแก้ไขสคริปต์เพียง 2 บรรทัดเท่านั้น เมื่อมีการใช้งานแทน SOAP::Lite ในการแฮ็กเป้าหมายต่างๆในหนังสือเล่มนี้

โค้ดของ PoXML

# PoXML.pm

# PoXML [pronounced "plain old xml"] is a dire-need drop-in

# replacement for SOAP::Lite designed for Google Web API hacking.

package PoXML;

use strict;

no strict "refs";

# LWP for making HTTP requests, XML for parsing Google SOAP

use LWP::UserAgent;

use XML::Simple;

# Create a new PoXML

sub new {

my $self = {};

bless($self);

return $self;

}

# Replacement for the SOAP::Lite-based doGoogleSearch method

sub doGoogleSearch {

my($self, %args);

($self, @args{qw/ key q start maxResults filter restrict

safeSearch lr ie oe /}) = @_;

# grab SOAP request from __DATA_ _

my $tell = tell(DATA);

my $soap_request = join '', ;

seek(DATA, $tell, 0);

$soap_request =~ s/\$(\w+)/$args{$1}/ge; #interpolate variables

# Make (POST) a SOAP-based request to Google

my $ua = LWP::UserAgent->new;

my $req = HTTP::Request->new(

POST => 'http://api.google.com/search/beta2');

$req->content_type('text/xml');

$req->content($soap_request);

my $res = $ua->request($req);

my $soap_response = $res->as_string;

# Drop the HTTP headers and so forth until the initial xml element

$soap_response =~ s/^.+?(<\?xml)/$1/migs;

# Drop element namespaces for tolerance of future prefix changes

$soap_response =~ s!(<\/?)[\w-]+?:([\w-]+?)!$1$2!g;

# Parse the XML

my $results = XMLin($soap_response);

# Normalize and drop the unnecessary encoding bits

my $return = $results->{'Body'}->{'doGoogleSearchResponse'}->{return};

foreach ( keys %{$return} ) {

$return->{$_}->{content} and

$return->{$_} = $return->{$_}->{content} || '';

}

my @items;

foreach my $item ( @{$return->{resultElements}->{item}} ) {

foreach my $key ( keys %$item ) {

$item->{$key} = $item->{$key}->{content} || '';

}

push @items, $item;

}

$return->{resultElements} = \@items;

my @categories;

foreach my $key ( keys %{$return->{directoryCategories}->{item}} ) {

$return->{directoryCategories}->{$key} =

$return->{directoryCategories}->{item}->{$key}->{content} || '';

}

# Return nice, clean, usable results

return $return;

}

# This is the SOAP message template sent to api.google.com. Variables

# signified with $variablename are replaced by the values of their

# counterparts sent to the doGoogleSearch subroutine.

__DATA_ _

<?xml version='1.0' encoding='UTF-8'?>

<SOAP-ENV:Envelope

xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:xsi="http://www.w3.org/1999/XMLSchema-instance"

xmlns:xsd="http://www.w3.org/1999/XMLSchema">

<SOAP-ENV:Body>

<ns1:doGoogleSearch xmlns:ns1="urn:GoogleSearch"

SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">

<start xsi:type="xsd:int">$start</start>

<maxResults xsi:type="xsd:int">$maxResults</maxResults>

<filter xsi:type="xsd:boolean">$filter</filter>

<restrict xsi:type="xsd:string">$restrict</restrict>

<safeSearch xsi:type="xsd:boolean">$safeSearch</safeSearch>

</ns1:doGoogleSearch>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

ข้างล่างนี้เป็นตัวอย่างสคริปต์ PoXML ในแง่การใช้งาน ซึ่งก็ไม่แตกต่างอะไรไปจากการแฮ็กในหัวข้ออื่นๆในหนังสือเล่มนี้ จะมีแต่ก็เพียงการเน้นข้อความเป็นตัวหนา (bold) ตรงส่วนที่มีการ comment ในบรรทัดที่เดิมใช้กับ SOAP::Lite และแทรกบรรทัดใหม่ เพื่อให้ใช้กับ PoXML ได้เท่านั้น

#!/usr/bin/perl

# poxml_google2csv.pl

# Google Web Search Results via PoXML ("plain old xml") module

# exported to CSV suitable for import into Excel

# Usage: poxml_google2csv.pl "{query}" [> results.csv]

# Your Google API developer's key

my $google_key = 'insert key here';

use strict;

# use SOAP::Lite;

use PoXML;

$ARGV[0]

or die qq{usage: perl poxml_search2csv.pl "{query}"\n};

# my $google_search = SOAP::Lite->service("file:$google_wdsl");

my $google_search = new PoXML;

my $results = $google_search ->

doGoogleSearch(

$google_key, shift @ARGV, 0, 10, "false",

"", "false", "", "latin1", "latin1"

);

@{$results->{'resultElements'}} or die('No results');

print qq{"title","url","snippet"\n};

foreach (@{$results->{'resultElements'}}) {

$_->{title} =~ s!"!""!g; # double escape " marks

$_->{snippet} =~ s!"!""!g;

my $output = qq{"$_->{title}","$_->{URL}","$_->{snippet}"\n};

$output =~ s!<.+?>!!g; # drop all HTML tags

print $output;

}

Running the Hack

รันสคริปต์นี้ที่ command line โดยการใส่คำถามลงไปที่ command line และระบุให้แสดงผลลัพธ์ในไฟล์ CSV ที่คุณต้องการสร้างขึ้นมา หรือที่ต้องการให้นำผลลัพธ์ไปต่อท้าย (เดิมมีผลลัพธ์อยู่บ้างแล้ว) ตัวอย่างเช่นข้างล่างนี้ใช้ “plain old xml” เป็นคำถาม และกำหนดไฟล์ results.csv เป็นไฟล์รับผลลัพธ์ที่ได้กลับคืนมา

$ perl poxml_google2csv.pl "plain old xml" > results.csv

หรือจะตัดส่วนของ > และ results.csv ออก เพื่อส่งผลลัพธ์ให้ไปแสดงที่หน้าจอเพื่อตรวจสอบก่อนก็ได้

ผลลัพธ์

% perl poxml_google2csv.pl "plain old xml"

"title","url","snippet"

"XML.com: Distributed XML [Sep. 06, 2000]",

"http://www.xml.com/pub/2000/09/06/distributed.html",

" ... extensible. Unlike plain old XML, there's no sense of

constraining what the document can describe by a DTD or schema.

This means ... "

...

"Plain Old Documentation",

"http://axkit.org/wiki/view/AxKit/PlainOldDocumentation",

" ... perlpodspec - Plain Old Documentation: format specification

and notes. ... Examples: =pod This is a plain Pod paragraph. ...

encodings in Pod parsing would be as in XML ... "

การใช้งานและข้อจำกัด

วางไฟล์ PoXML.pm ไว้ในไดเรกทอรีเดียวกันกับสคริปต์ของเรื่องที่จะแฮ็ก
แทนที่บรรทัดในสคริปต์ที่เป็น use SOAP::Lite; ด้วย use PoXML;
แทนที่ my $google_search = SOAP::Lite->service(“file:$google_wdsl”); ด้วย my $google_search = new PoXML;

อย่างไรก็ตาม ยังมีข้อจำกัดในการใช้งานอยู่บ้าง ในขณะที่ PoXML ทำงานได้ดีในการดึงผลลัพธ์รวมทั้งสรุปผลลัพธ์ที่ได้จากการค้นหา แต่ก็ไม่ประสบผลสำเร็จในด้านการรวบรวมผลลัพธ์ในขั้นละเอียดขึ้น (Advanced Result) บางอย่าง เช่น <directoryCategories> ซึ่งเป็นลิสต์รายการหมวดของไดเรกทอรี เป็นต้น

ดูเพิ่มเติม

NoXML [Hack #54] เป็นทางเลือกในการใช้แทน SOAP::Lite ซึ่งใช้เพียง regular expression ทำงาน โดยไม่ต้องใช้ XML parser แต่อย่างใด

XooMLE [Hack #36] เป็น Third-party service ซึ่งเป็นตัวกลางในการเชื่อมต่อระหว่าง Plain Old XML กับ Google We แก้ไขบทความ b API

HACK#52 โมดูล SOAP::Lite ของ Perl

2007-08-08T14:07:00.000+07:00

อธิบายการติดตั้งโมดูล SOAP::Lite ของ Perl ซึ่งถือเป็นหัวใจสำคัญในการพัฒนาแอพพลิเคชันที่เป็นเว็บเซอร์วิส

SOAP::Lite (http://www.soaplite.com) เป็นมาตรฐานในการติดต่อกับ Saop-Based Web Service จาก Perl ที่ถูกใช้เป็นส่วนใหญ่ในหนังสือเล่มนี้ ซึ่งเนื้อหาในบทที่ 6 เกือบทั้งหมดจะใช้โมดูลนี้เป็นหลัก

ปัญหาระหว่าง SOAP::Lite กับ ISP ของคุณ

โชคไม่ดีสักเท่าไหร่ ที่ ISP บางแห่งไม่สนับสนุนการใช้งาน SOAP::Lite ให้แก่สมาชิกของเขา โดยทั่วไปแล้ว ISP ส่วนใหญ่จะจำกัดการใช้งานโมดูลเพิ่มเติมบางอย่าง รวมทั้งความสามารถในการ Execute สคริปต์ต่างๆของบรรดาสมาชิก ดังนั้นก่อนที่คุณจะเสียเวลาทำการติดตั้ง SOAP::Lite ก็น่าจะสอบถาม ISP ที่คุณใช้บริการอยู่ว่าสนับสนุนการใช้งาน SOAP::Lite หรือเปล่า

การติดตั้ง SOAP::Lite

บางครั้งวิธีที่ง่ายที่สุดในการติดตั้งโมดูล SOAP::Lite ก็คือการติดตั้งผ่านโมดูลอีกอันหนึ่งของ Perl ซึ่งก็คือ CPAN (มีอยู่แล้วในดิสทริบิวชันรุ่นใหม่ๆของ Perl) ซึ่งจะทำการติดตั้งโมดูลต่างๆของ Perl ให้โดยอัตโนมัติ รวมทั้งรับเอาคอมโพเนนต์ต่างๆเข้ามาด้วย

Tip: CPAN จะติดตั้งโมดูลต่างๆลงไปในโฟลเดอร์มาตรฐานของแต่ละระบบที่นิยมติดตั้งโปรแกรมลงไป ดังนั้นคุณจึงต้องทำการติดตั้งในฐานะ Root User เท่านั้น แต่ถ้าหากคุณเป็นผู้ใช้ทั่วไป (regular user) คุณจะต้องติดตั้ง SOAP::Lite รวมถึงสิ่งที่อาจจะต้องติดตั้งก่อนหน้านั้น (prerequisite) โดยตัวคุณเอง (ดู “การติดตั้งภายใต้ Unix ด้วยตัวเอง”)

การติดตั้ง SOAP::Lite ด้วย CPAN ภายใต้ระบบ Unix และ Mac OS X

ถ้าหากคุณมีโมดูล CPAN อยู่แล้ว รวมทั้งคุณเป็น root ของระบบและเชื่อมต่อกับอินเทอร์เน็ตอยู่ การติดตั้งจะทำโดยการใช้คำสั่งดังนี้

% su

Password:

# perl -MCPAN -e shell

cpan shell -- CPAN exploration and modules installation (v1.52)

ReadLine support available (try ``install Bundle::CPAN'')

cpan> install SOAP::Lite

หรือถ้าหากต้องการติดตั้งง่ายๆด้วยคำสั่งเพียงบรรทัดเดียวก็ย่อมทำได้ ดังนี้

% sudo perl -MCPAN -e 'install SOAP::Lite'

คุณอาจจะถูกถามคำถามสัก 2-3 คำถาม ซึ่งก็สามารถตอบได้ง่ายๆโดยเพียงการกดปุ่ม Enter เพื่อตอบคำถามนั้นๆตามค่าเริ่มต้น (default) ที่โปรแกรมกำหนดมาให้เท่านั้น

การติดตั้งภายใต้ระบบ Unix

ถ้าหากการติดตั้ง SOAP::Lite ด้วย CPAN ไม่สำเร็จ มีอีกวิธีหนึ่งคือคุณต้องติดตั้งด้วยตัวคุณเองทีละขั้นตอน แต่ก่อนอื่นคุณต้องดาวน์โหลด SOAP::Lite เวอร์ชันล่าสุดมาจาก SOAPLite.com (http://www.soaplite.com) เสียก่อน จากนั้นก็ unpack ไฟล์ที่ได้มาแล้วทำตามขั้นตอนดังต่อไปนี้

% tar xvzf SOAP-Lite-latest.tar.gz

SOAP-Lite-0.55

SOAP-Lite-0.55/Changes

...

SOAP-Lite-0.55/t/37-mod_xmlrpc.t

SOAP-Lite-0.55/t/TEST.pl

% cd SOAP-Lite-0.55

% perl Makefile.PL

...

% make

mkdir blib

mkdir blib/lib

...

% make test

PERL_DL_NONLAZY=1 /usr/bin/perl -Iblib/arch -Iblib/lib

-I/System/Library/Perl/darwin -I/System/Library/Perl -e 'use

Test::Harness qw(&runtests $verbose); $verbose=0; runtests @ARGV;'

t/01-core.t t/02-payload.t t/03-server.t t/04-attach.t t/05-customxml.t

t/06-modules.t t/07-xmlrpc_payload.t t/08-schema.t t/01-core...........

...

% su

Password:

# make install

Installing /Library/Perl/XMLRPC/Lite.pm

Installing /Library/Perl/XMLRPC/Test.pm

ถ้าหากในระหว่างการติดตั้งอยู่นั้น คุณได้รับข้อความเตือน (warning message) ให้ติดตั้งโปรแกรมที่จำเป็นต้องมีก่อน (prerequisite) จึงจะติดตั้ง SOAP::Lite ได้แล้วล่ะก็ คุณจำเป็นต้องติดตั้งโปรแกรมนั้นๆก่อน แล้วค่อยกลับมาติดตั้ง SOAP::Lite ใหม่อีกที ซึ่งโดยปกติข้อความดังกล่าวมักจะมีลักษณะดังนี้

Checking if your kit is complete...

Looks good

Warning: prerequisite HTTP::Daemon failed to load: Can't locate

HTTP/Daemon.pm in @INC (@INC contains: /System/Library/Perl/darwin

/System/Library/Perl /Library/Perl/darwin /Library/Perl /Library/Perl

/Network/Library/Perl/darwin /Network/Library/Perl

/Network/Library/Perl .) at (eval 8) line 3.

ถ้าหากคุณเป็น User ทั่วไปที่ไม่ใช่ Root แล้วต้องการติดตั้ง SOAP::Lite ด้วยตัวคุณเอง คุณจะต้องติดตั้งสิ่งต่างๆทั้งหมดที่กล่าวมาแล้วลงใน home directory ของคุณเท่านั้น ซึ่งใน ~/lib นับเป็นที่ที่ค่อนข้างเหมาะสมในการติดตั้งสิ่งต่างๆลงไป โดยการใช้คำสั่งดังนี้

% perl Makefile.PL LIB=/home/login/lib

การติดตั้ง SOAP::Lite ในวินโดว์ด้วย PPM

ถ้าหากคุณจะใช้ Perl ภายใต้ระบบปฏิบัติการวินโดว์ ก็นับเป็นโอกาสอันดีของ ActivePerl ซึ่งเป็นดิสทริบิวชันจากบริษัท ActiveState (http://www.activestate.com/Products/ActivePerl) ที่จะได้รับใช้คุณ และคงต้องขอขอบคุณ ActivePerl สำหรับโมดูลการติดตั้งที่ทำหน้าที่คล้ายกับ CPAN ซึ่งนั่นก็คือ Programmer’s Package Manager (PPM, http://aspn.activestate.com/ASPN/Downloads/ActivePerl/PPM/) ซึ่งจะทำการติดตั้งโมดูลต่างๆจาก ActiveState ลงสู่วินโดว์ด้วยความง่ายดาย โดยคุณแทบจะไม่ต้องสั่งคำสั่งใดๆเพิ่มเติมเลย

ขั้นตอนก็เพียงเรียก PPM จาก command line ในดอสแล้วติดตั้ง SOAP::Lite ด้วยคำสั่งนี้

C:\>ppm

PPM interactive shell (2.1.6) - type 'help' for available commands.

PPM> install SOAP::Lite

ถ้าหากคุณดาวน์โหลด ActivePerl เวอร์ชันใหม่ๆมา คุณอาจจะได้รับข้อความแจ้งว่า SOAP::Lite ได้ถูกติดตั้งอยู่แล้ว

C:\>ppm

PPM interactive shell (2.1.6) - type 'help' for available commands.

PPM> install SOAP::Lite

Version 0.55 of 'SOAP-Lite' is already installed.

ทางเลือกอื่นๆนอกจาก SOAP::Lite

บางครั้ง ISP ของคุณอาจจะไม่ได้มองว่า SOAP::Lite มีความสำคัญพอที่จะให้การสนับสนุน ซึ่งถ้าเป็นดังนั้น การติดตั้งของคุณอาจจะทำให้คุณเสียเวลาเปล่าก็ได้

ในขณะที่ SOAP::Lite เป็นโมดูลที่ค่อนข้างลงตัวสำหรับการติดต่อกับ Google Web API รวมถึง Web Service โดยทั่วไปด้วย แต่ก็เป็นการยากที่จะยอมให้ผู้ใช้งานที่ไม่สามารถใช้ SOAP::Lite อันเนื่องมาจาก ISP ที่ใช้อยู่ไม่สนับสนุน พลาดโอกาสใช้งานจากประโยชน์อันมากมายของหนังสือเล่มนี้

ไม่ต้องเป็นห่วง! เรายังมีทางเลือกอยู่ โดยการใช้ PoXML [Hack #53] ซึ่งเป็นเพิร์ลโมดูลขนาดเล็กๆของเราเอง ซึ่งจะทำงานร่วมกับ SOAP ของ Google ในแบบ Plain Old XML ด้วยการใช้ LWP::UserAgent เพื่อสร้าง HTTP request และใช้ XML::Simple สำหรับประมวลผล XML response

นอกจาก PoXML แล้วยังมี NoXML [Hack #54] ซึ่งไม่ต้องการแม้กระทั่งตัวประมวลผล XML (XML parser) ใดๆเลย แต่จะทำงานทุกอย่างด้วย Regular Expression จากนั้นก็มี XooMLe [Hack #36] ซึ่งเป็น third-party service มาเป็นตัวกลางในการติดต่อกับ Google Web API อีกทีหนึ่ง ซึ่งการใช้งานทั้ง PoXML และ NoXML แทน SOAP::Lite นั้น ไม่ได้ยุ่งยากไปกว่าการแก้ไขในสคริปต์ที่เดิมใช้กับ SOAP::Lite เพียงแค่ 2 บรรทัดเท่านั้น

HACK#51 การวนลูปเพื่อเพิ่มจำนวนผลลัพธ์

2007-08-08T11:54:00.000+07:00

ถ้าหากคุณต้องการผลลัพธ์มากกว่า 10 รายการขึ้นไป คุณจำเป็นต้องใช้การวนลูปเข้าช่วย

ดังที่ทราบว่า Google Web API จะคืนค่าผลลัพธ์ให้เพียง 10 รายการต่อการค้นหาหนึ่งครั้งเท่านั้น ซึ่งอาจจะเพียงพอสำหรับคำถามบางคำถาม แต่สำหรับบางคำถามแล้ว ผลลัพธ์ 10 รายการอาจจะไม่เพียงพอก็เป็นได้ อย่างไรก็ตาม หากคุณต้องการผลลัพธ์ที่มากกว่านั้น คุณสามารถใช้การวนลูปเข้าช่วย โดยการวนลูปเพื่อส่ง query (ดูสคริปต์) เข้าไปสอบถามเพื่อให้ได้ผลลัพธ์ 10 รายการถัดไป ซึ่งก็คือรายการที่ 11 ถึงรายการที่ 20 และรอบถัดไปก็คือรายการที่ 21 ถึงรายการที่ 30 เป็นเช่นนี้ไปเรื่อยๆ ซึ่งจำนวนผลลัพธ์ที่ได้ ขึ้นอยู่กับจำนวนลูปที่คุณกำหนด

หัวข้อนี้เป็นการนำสิ่งที่ได้แนะนำเอาไว้ใน “การเขียนโปรแกรม Google Web API ด้วยภาษา Perl” [Hack #50] มาใช้ ซึ่งการเพิ่มจำนวนผลลัพธ์จากการค้นหาให้ได้มากกว่า 10 รายการนั้น ไม่มีสิ่งใดต้องโปรแกรมเพิ่ม นอกจากการวนลูปเท่านั้น ซึ่งสคริปต์ที่เห็นข้างล่างนี้เขียนด้วยภาษา Perl โดยส่วนที่เป็นตัวหนา (bold) เป็นส่วนที่เพิ่มขึ้นมาจาก Hack#50 เพื่อใช้ในการสร้างลูปเท่านั้น

โค้ดตัวอย่าง

#!/usr/local/bin/perl

# looply.pl

# A typical Google Web API Perl script

# Usage: perl looply.pl

# Your Google API developer's key

my $google_key='insert key here';

# Location of the GoogleSearch WSDL file

my $google_wdsl = "./GoogleSearch.wsdl";

# Number of times to loop, retrieving 10 results at a time

my $loops = 3; # 3 loops x 10 results per loop = top 30 results

use strict;

# Use the SOAP::Lite Perl module

use SOAP::Lite;

# Take the query from the command-line

my $query = shift @ARGV or die "Usage: perl looply.pl \n";

# Create a new SOAP::Lite instance, feeding it GoogleSearch.wsdl

my $google_search = SOAP::Lite->service("file:$google_wdsl");

# Keep track of result number

my $number = 0;

for (my $offset = 0; $offset <= ($loops-1)*10; $offset += 10) {

# Query Google

my $results = $google_search ->

doGoogleSearch(

$google_key, $query, $offset, 10, "false", "", "false",

"", "latin1", "latin1"

);

# No sense continuing unless there are more results

last unless @{$results->{resultElements}};

# Loop through the results

foreach my $result (@{$results->{'resultElements'}}) {

# Print out the main bits of each result

join "\n",

++$number,

$result->{title} || "no title",

$result->{URL},

$result->{snippet} || 'no snippet',

"\n";

}

สังเกตว่าสคริปต์ข้างบนจะแจ้ง Google ถึงจำนวนรอบที่ต้องการโดยเพียงการผ่านค่าตัวแปร $offset เท่านั้น ซึ่ง $offset += 10 หมายถึงการเพิ่มผลลัพธ์ครั้งละ 10 รายการต่อรอบนั่นเอง

Running the Script

รันสคริปต์นี้ที่ command line โดยการใส่คำที่ต้องการค้นหาลงไปแทน query

$perl looply.pl “query”

ผลลัพธ์

% perl looply.pl

Usage: perl looply.pl

% perl looply.pl "learning perl"

oreilly.com -- Online Catalog: Learning Perl, 3rd Edition

http://www.oreilly.com/catalog/lperl3/

... Learning Perl, 3rd Edition Making Easy Things

Easy and Hard Things Possible By Randal
L. Schwartz, Tom Phoenix

3rd Edition July 2001 0-596-00132-0, Order Number ...

...

Intro to Perl for CGI

http://hotwired.lycos.com/webmonkey/98/47/index2a.html

... Some people feel that the benefits of learning

Perl scripting are few.
But ... part. That's right.

Learning Perl is just like being a cop. ...

WebDeveloper.com ฎ: Where Web Developers and Designers Learn How ...

http://www.webdeveloper.com/reviews/book6.html

... Registration CreditCard Processing Compare Prices.

Learning Perl. Learning
Perl, 2nd Edition.

Publisher: O'Reilly Author: Randal Schwartz ...

ดูเพิ่มเติม

การเขียนโปรแกรม Google Web API ด้วย Perl [Hack #50]

HACK#50 การเขียนโปรแกรม Google Web API ด้วยภาษา Perl

2007-08-08T11:49:00.000+07:00

บทนี้เป็นสคริปต์ง่ายๆ ซึ่งจะแสดงให้เห็นพื้นฐานการเขียนโปรแกรม Google Web API ด้วย Perl และเป็นการแนะนำส่วนที่เป็นพื้นฐานสำคัญ ซึ่งเป็นส่วนที่มีการใช้มากสุดในหนังสือเล่มนี้

การแฮ็กส่วนใหญ่ในหนังสือเล่มนี้จะใช้ภาษา Perl เป็นหลัก ซึ่งรายละเอียดเพิ่มเติมจะแตกต่างกันไป แล้วแต่วิธีการแฮ็ก แต่โดยส่วนใหญ่แล้วจะเป็นการส่งค่าผ่าน Google Web API รวมทั้งการแสดงผลลัพธ์เป็นหลัก สำหรับใน Hack #50 นี้เป็นส่วนที่เป็นพื้นฐานสำคัญ ในการที่จะทำให้คุณได้ทราบถึงวิธีการพัฒนาแอพพลิเคชันที่น่าสนใจและซับซ้อนมากยิ่งขึ้น สำหรับท่านที่ยังไม่มีวิธีการ หรือขั้นตอนในการทดสอบที่เตรียมเอาไว้ในใจก่อนหน้านี้ เนื้อหาใน Hack#50 นี้น่าจะเป็นจุดเริ่มต้นที่ดีในการทดสอบผลการทำงานผ่าน Google Web API เนื่องจากในแฮ็กนี้จะเป็นการส่งคำสั่งค้นหาไปยัง Google และแสดงผลลัพธ์ของคำสั่งนั้นออกมานั่นเอง

โค้ดตัวอย่าง

#!/usr/local/bin/perl

# googly.pl

# A typical Google Web API Perl script

# Usage: perl googly.pl

# Your Google API developer's key

my $google_key='insert key here';

# Location of the GoogleSearch WSDL file

my $google_wdsl = "./GoogleSearch.wsdl";

use strict;

# Use the SOAP::Lite Perl module

use SOAP::Lite;

# Take the query from the command-line

my $query = shift @ARGV or die "Usage: perl googly.pl \n";

# Create a new SOAP::Lite instance, feeding it GoogleSearch.wsdl

my $google_search = SOAP::Lite->service("file:$google_wdsl");

# Query Google

my $results = $google_search ->

doGoogleSearch(

$google_key, $query, 0, 10, "false", "", "false",

"", "latin1", "latin1"

);

# No results?

@{$results->{resultElements}} or exit;

# Loop through the results

foreach my $result (@{$results->{resultElements}}) {

# Print out the main bits of each result

join "\n",

$result->{title} || "no title",

$result->{URL},

$result->{snippet} || 'no snippet',

"\n";

}

Running the Hack

การใช้งานก็เพียงรันสคริปต์นี้ที่ command line โดยใส่คำถามที่คุณต้องการลงไปแทน query keywords

$ perl googly.pl “query keywords”

ผลลัพธ์

ข้างล่างนี้เป็นตัวอย่างผลลัพธ์ที่ได้จากการรันสคริปต์ ซึ่งในการค้นหาครั้งแรกเราไม่ได้ระบุคำถามในการค้นหาลงไป ซึ่งทำให้ไม่มีผลลัพธ์ใดๆออกมา นอกจากข้อความว่า Usage: perl googly.pl ส่วนครั้งที่สองระบุคำว่า learning perl เป็นคำถาม ซึ่งก็ได้ผลลัพธ์ตามที่เห็นข้างล่างนี้

% perl googly.pl

Usage: perl googly.pl

% perl googly.pl "learning perl"

oreilly.com -- Online Catalog: Learning

Perl, 3rd Edition

http://www.oreilly.com/catalog/lperl3/

... learning perl, 3rd Edition Making Easy Things Easy and Hard Things

Possible By Randal L. Schwartz, Tom Phoenix 3rd Edition July

2001 0-596-00132-0

...

Amazon.com: buying info: learning perl (2nd Edition)

http://www.amazon.com/exec/obidos/ASIN/1565922840

... learning perl takes common programming idioms and expresses them

in "perlish"
terms. ... (learning perl,

Programming Perl, Perl Cookbook).

ดูเพิ่มเติม

การวนลูปเพื่อเพิ่มจำนวนผลลัพธ์ [Hack #51]

บทที่ 5 ทำความรู้จักกับ Google Web API

2007-08-08T11:48:00.000+07:00

การแนะนำ Google Web API และการลงทะเบียนเพื่อขอ API Code กับ Google

ทำไมจึงต้องเป็น API

เมื่อแรกเริ่มที่ Search Engine ต่างๆทยอยเกิดขึ้นนั้น จะค่อนข้างเปิดกว้างสำหรับการนำทรัพยากรต่างๆใน Search Engine นั้นๆมาใช้ประโยชน์ค่อนข้างมาก เว็บไซต์อย่าง Excite และ AltaVista นั้นแทบจะไม่สนใจกับบุคคลบางกลุ่มที่ใช้ภาษา Perl เป็นเครื่องมือในการดึงข้อมูลบางส่วนไปใช้ประโยชน์ในงานของตัวเองเลย หรืออาจจะเป็น Meta Search Engine (Search Engine ที่ไม่ได้สร้างฐานข้อมูลของตนเอง แต่จะค้นหาข้อมูลจากจากฐานข้อมูลของ Search Engine ตัวอื่นอีกทีหนึ่ง) ซึ่งรวมเอาผลลัพธ์จากการค้นหาภายในฐานข้อมูลของหลายๆที่เข้าเป็นฐานข้อมูลของตัวเองอีกทีหนึ่ง ซึ่งแน่นอนที่สุดที่บางส่วนอาจถูกปิดกั้นไม่ให้กระทำเช่นนั้นได้ แต่โดยทั่วไปแล้ว Search Engine เหล่านั้นก็ไม่ได้กังวลหรือหวงแหนอะไรมากนัก สำหรับการแบ่งปันข้อมูลที่ไม่ได้สลักสำคัญอะไร

แต่สำหรับ Google แล้วกลับไม่ได้คิดเช่นนั้น ตรงกันข้าม Google พยายามป้องกันเหล่า Meta Search Engine ทั้งหลายที่ใช้เนื้อหา (content) ของตัวเองโดยปราศจากใบอนุญาต (License) รวมทั้งพยายามอย่างเต็มที่ที่จะบล็อก Web Agent ที่ไม่รู้จัก อย่างเช่นโมดูล LWP::Simple ของ Perl หรือแม้แต่ wget ที่ทำงานแบบ command line และยิ่งไปกว่านั้น Google จะทำการบล็อก IP address ที่ได้ทำการรันคำสั่งค้นหา (query) ข้อมูลใน Google โดยอัตโนมัติด้วย

Google มองว่าตัวเองมีสิทธิ์เต็มที่ในการกระทำเช่นนั้น ทั้งนี้เนื่องจากไม่ว่าจะเป็นเทคโนโลยีในการค้นหา (Search Technology) ฐานข้อมูล (Database) และเครื่องคอมพิวเตอร์ที่สร้างสิ่งเหล่านี้ขึ้นมา ก็ล้วนแต่เป็นของ Google เองทั้งสิ้น แม้กระนั้นก็ตาม Google เองก็ตระหนักเช่นกันว่า นโยบายนี้เป็นการปิดโอกาสในการที่เราๆท่านๆทั้งหลายจะสามารถใช้ประโยชน์จากฐานข้อมูลอันกว้างใหญ่ไพศาลของ Google ได้อย่างอัตโนมัติ

แต่แล้วในฤดูใบไม้ผลิปี 2002 ทุกสิ่งทุกอย่างก็ได้เปลี่ยนไป โดยที่ Google ได้ให้กำเนิด Google Web API (http://api.google.com/) เป็นครั้งแรก ซึ่งแม้เราจะไม่สามารถค้นหาทุกสิ่งทุกอย่างผ่าน Google Web API นี้ได้ (เช่นซินแท็กซ์พิเศษอย่าง Phonebook: ใน Hack #17 เป็นต้น) แต่ก็เปิดโอกาสให้นักพัฒนาโปรแกรมสามารถเข้าถึงฐานข้อมูลขนาดมหึมา ทำให้สามารถสร้างอินเทอร์เฟสของพวกเขาเองเพื่อใช้ผลลัพธ์ของการค้นหา (search result) จาก Google ได้ตามแบบที่เขาต้องการ

Tip : API ย่อมาจาก “Application Programming Interface” ซึ่งถือเป็นเสมือนประตูสำหรับการพัฒนาโปรแกรมเพื่อเข้าใช้ทรัพยากรบางอย่างหรือแอพพลิเคชันบางตัว ซึ่งในกรณีนี้ ทรัพยากรดังกล่าวก็คือ Google Index หรือฐานข้อมูลที่ Google ได้จัดทำอินเด็กซ์เอาไว้นั่นเอง

มาถึงตรงจุดนี้บางท่านคงจะสนใจที่จะเข้ามีส่วนร่วมในการใช้งาน Google Web API กันบ้างแล้วสินะ

ถ้าเป็นเช่นนั้น ก่อนอื่นคุณต้องลงทะเบียนเพื่อรับ Developer Key กันเสียก่อน เพื่อให้สามารถใช้งาน Google Web API ได้ ซึ่งคีย์ที่คุณได้รับมานั้น Google จะอนุญาตให้ใช้คีย์ดังกล่าวเข้าติดต่อเพื่อค้นหาข้อมูลได้วันละไม่เกิน 1,000 ครั้ง และถึงแม้คุณไม่ได้คิดจะสร้างแอพพลิเคชันใดๆเลยก็ตาม คุณก็ยังสามารถใช้ประโยชน์จาก Developer Key นี้ได้อีกประการหนึ่ง เนื่องจากมีพวก Third-Party Application (แอพพลิเคชันที่บริษัทอื่นๆ ที่ไม่ใช่ Google พัฒนาขึ้นมา) จำนวนมากที่สร้างขึ้นมา และคุณก็สามารถนำมาใช้งานได้เลย โดยที่แอพพลิเคชันเหล่านั้นก็ จำเป็นต้องใช้ Developer Key ในการติดต่อกับ Google ด้วยเหมือนกัน

การลงทะเบียน (Sign Up) กับ Google
การลงทะเบียนเพื่อที่จะได้รับ Developer Key สำหรับ Google Web API นั้นค่อนข้างง่ายมาก ขั้นตอนแรกคุณต้องเปิดบัญชีกับ Google เสียก่อน จากนั้นก็จะได้ Google Web API และคำตอบรับจาก Google ส่งกลับคืนมา สำหรับการลงทะเบียนก็เพียงแค่กรอก E-mail Address และ Password ที่ถูกต้องเท่านั้น คุณก็จะสามารถ Login เข้าไปหารายละเอียดเพิ่มเติมและสามารถใช้งานแอพพลิเคชันของ Google ได้ด้วยตนเอง

แน่นอนที่สุด คุณต้องเห็นด้วยและยอมรับ Terms & Conditions ต่างๆที่ Google ประกาศเอาไว้ด้วย (http://www.google.com/apis/download.html) ก่อนที่คุณจะสามารถดำเนินการอย่างหนึ่งอย่างใดได้ต่อไป โดยคำประกาศดังกล่าว พอจะสรุปคร่าวๆได้ดังนี้

Google อาจจะไม่สามารถควบคุมเนื้อหาที่ปรากฏใน Google Index ได้ทั้งหมด ดังนั้นการใช้งาน Google Web API อาจจะให้ผลลัพธ์ที่เป็นข้อความที่ไม่พึงประสงค์ก็ย่อมได้
การใช้งาน Google Web API สามารถใช้ได้กับเฉพาะงานส่วนบุคคลเท่านั้น ไม่สามารถใช้งานในลักษณะก่อให้เกิดประโยชน์ในเชิงการค้าได้ ไม่ว่าจะเป็นการนำไปขาย ให้บริการ หรือการโฆษณาก็ตาม
Google ไม่รับผิดชอบต่อความเสียหายอันเนื่องมาจากการใช้งาน และจริงๆแล้ว Google Web API ก็ยังเป็น Beta Version อยู่ด้วย
คุณอาจจะระบุว่าโปรแกรมที่คุณพัฒนาขึ้นมีการใช้ Google Web API แต่โปรแกรมนั้นจะต้องไม่ “(1) ทำให้เสื่อมเสีย ล่วงละเมิด หรือทำให้เสียหายซึ่งเครื่องหมายการค้าของ Google (2) ผิดกฎหมายโดยชัดแจ้ง (3) ละเมิดสิทธิ์อย่างหนึ่งอย่างใดในโปรแกรมของบุคคลที่สาม” และสำหรับการใช้เครื่องหมายการค้า (Trademark) หรือสัญลักษณ์ (Logo) ของ Google จะต้องได้รับการอนุญาตเป็นลายลักษณ์อักษรเท่านั้น

Google Web API Developer’s Kit (ชุดพัฒนาแอพพลิเคชั่นสำหรับ Google)

ถ้าหากคุณสนใจที่จะเขียนโปรแกรม คุณสามารถดาวน์โหลด Google Web API Developer’s Kit ได้ที่ http://www.google.com/apis/download.html เช่นกัน ซึ่งในชุดจะประกอบด้วย
(หมายเหตุ : Link อาจมีการเปลี่ยนแปลง)

ไฟล์ WSDL ในหลากหลายแพล็ตฟอร์ม
Java Wrapper Library ซึ่งรวบรวมวิธีเชื่อมต่อกับ SOAP เอาไว้
ตัวอย่างของแอพพลิเคชันที่สร้างด้วยเทคโนโลยี .NET ของไมโครซอฟต์
เอกสารประกอบ (documentation) ซึ่งรวมทั้ง JavaDoc และ SOAP XML

เพียงแค่คลิกลิงก์ download จากนั้น unzip ไฟล์ที่ได้มา อ่านไฟล์ readme.txt แล้วทำตามคำแนะนำในไฟล์เท่านั้น คุณก็สามารถพัฒนาแอพพลิเคชันของตนเองได้แล้ว

การใช้คีย์ในการแฮ็ก

ทุกๆครั้งที่คุณส่ง request ไปยังเซิร์ฟเวอร์ของ Google คุณจะต้องใส่คีย์ของคุณไปพร้อมกันด้วย ซึ่ง Google จะทำการเช็คคีย์ว่าถูกต้องหรือเปล่า รวมทั้งตรวจสอบด้วยว่ามีการส่งคำสั่งค้นหา (query) เกินกว่า 1000 ครั้งในวันนั้นแล้วหรือไม่ หากทุกอย่างถูกต้องไม่มีปัญหา Google จึงจะทำการประมวลผล request ของคุณ และทำการส่งค่ากลับมาให้

โปรแกรมทั้งหมดในหนังสือเล่มนี้ ไม่ว่าจะใช้ภาษาอะไรหรือแพล็ตฟอร์มใดก็ตาม จะมีจุดสำหรับแทรกคีย์ของคุณลงไปในโปรแกรมนั้นๆเสมอ ซึ่งโดยปกติแล้วคีย์ดังกล่าวนั้นจะเป็นแถวของอักขระ (string) ที่เกิดจากการสุ่มขึ้นมานั่นเอง

สำหรับภาษา Perl แล้วมักจะอยู่ในรูปแบบดังนี้

...

# Your Google API developer's key

my $google_key='insert key here';

...

ส่วน Java GoogleAPIDemo ที่มาพร้อมกันกับ Google Web APIs Developer’s Kit จะมีรูปแบบดังนี้

% java -cp googleapi.jar com.google.soap.search.GoogleAPIDemo

insert_key_here search ostrich

จะเห็นว่าในทั้งสองกรณี จะมีคำว่า insert key here หรือ insert_key_here (มีขีดล่าง) ซึ่งจะถูกแทนที่ด้วยคีย์ของคุณ ตัวอย่างเช่น ผู้เขียนแทรกคีย์เข้าไปใน Perl Script ในลักษณะนี้

...

# Your Google API developer's key

my $google_key='12BuCK13mY5h0E/34KN0cK@ttH3Do0R';

...

WSDL คืออะไร?

คำว่า WSDL นี้อ่านว่า “whiz-dill” ซึ่งย่อมาจาก Web Service Description Language ซึ่งเป็น XML รูปแบบหนึ่งในการอธิบาย Web Service ซึ่งส่วนที่สำคัญและมีประโยชน์ที่สุดเป็นส่วนหนึ่งของ Google Web APIs Developer’s Kit นั้นก็คือ GoogleSearch.wsdl ซึ่งเป็นไฟล์ WSDL ที่จะอธิบายเซอร์วิสรวมทั้งชื่อเมธอดและอาร์กิวเมนต์ต่างๆที่จะสามารถนำมาใช้งานได้

โดยปกติแล้ว การเก็บไฟล์ GoogleSearch.wsdl เอาไว้ในไดเร็กทอรีเดียวกันกับสคริปต์ที่คุณเขียนจะเป็นวิธีที่ง่ายที่สุด อย่างไรก็ตาม ถ้าหากคุณต้องการที่จะเก็บไฟล์นี้เอาไว้ในไดเร็กทอรีอื่น อย่าลืมเปลี่ยนตำแหน่งของไฟล์ (path) ให้ถูกต้องด้วยก็แล้วกัน ซึ่งโดยปกติแล้วมักจะระบุตำแหน่งของไฟล์ WSDL ดังนี้

...

# Location of the GoogleSearch WSDL file

my $google_wdsl = "./GoogleSearch.wsdl";

...

สำหรับผู้เขียนเก็บไฟล์ดังกล่าวเอาไว้ในไดเรกทอรี library ดังนั้นจึงเปลี่ยนพาธจากเดิมที่เหมือนข้างบน มาเป็นข้างล่างนี้

...

# Location of the GoogleSearch WSDL file

my $google_wdsl = "/home/me/lib/GoogleSearch.wsdl";

...

ทำความเข้าใจกับ Google API Query

หัวใจหลักของ Google application ก็คือ “การค้นหา” (query) ซึ่งถ้าปราศจากการค้นหาแล้ว ก็ย่อมไม่มีข้อมูลกลับคืนมาอย่างแน่นอน และเนื่องจากเป็นสิ่งสำคัญ เราจึงน่าจะมาทำความเข้าใจโครงสร้างของการส่งคำสั่งค้นหากันสักหน่อย

รูปแบบการค้นหา (query essential)

สำหรับ Google Web API ที่ใช้ภาษา Perl ซึ่งจะส่งคำสั่งค้นหาไปยัง Google จะมีลักษณะดังนี้

my $results = $google_search ->

doGoogleSearch(

key, query, start, maxResults,

filter, restrict, safeSearch, lr,

ie, oe

);

รายการที่อยู่ในวงเล็บจะเป็นตัวแปร ตัวเลข หรือค่าตรรกะอย่างใดอย่างหนึ่ง สำหรับตัวอย่างข้างบนนี้ เป็นชื่อของอาร์กิวเมนต์ (Name of Argument) ชนิดต่างๆซึ่งอธิบายได้ดังนี้

key

เป็นจุ
ดที่คุณต้องแทรกคีย์ของ Google API เข้าไป ซึ่งถ้าหากปราศจากคีย์แล้ว การส่งคำสั่งค้นหาจะไม่ทำงาน

query

ส่วนนี้เป็นคำค้นหา (query word) ของคุณ ซึ่งประกอบด้วยคีย์เวิร์ด วลี และซินแท็กซ์ต่างๆ

start

เป็นการกำหนดจุดเริ่มต้นของรายการผลลัพธ์ที่จะแสดงว่า ต้องการให้แสดงผลลัพธ์ตั้งแต่รายการที่เท่าไหร่เป็นต้นไป เช่นถ้ากำหนดเอาไว้ที่ 16 สำหรับการค้นหาผลลัพธ์ 10 รายการ Google Web API จะส่งผลลัพธ์รายการที่ 16-25 มาให้ แต่ถ้ากำหนดเอาไว้ที่ 300 รายการ ก็จะได้ผลลัพธ์ตั้งแต่รายการที่ 300-309 กลับมา เป็นต้น (ทั้งนี้ผลลัพธ์ที่ได้จากการค้นหาทั้งหมดจะต้องมากพอสำหรับตัวเลขนั้นๆด้วย) การนับจะเริ่มนับที่เลข 0 (zero-based index) ไม่ใช่เลข 1 ดังนั้นผลลัพธ์รายการแรกก็คือผลลัพธ์หมายเลข 0 นั่นเอง ซึ่งจริงอยู่ที่มันอาจจะดูแปลกสักหน่อย แต่มันก็สามารถใช้งานได้สะดวกดี ข้อสังเกตก็คือ ค่าที่สามารถใช้ได้จะอยู่ระหว่าง 0-999 เนื่องจาก Google จะส่งผลลัพธ์กลับคืนมาได้ไม่เกิน 1,000 รายการต่อการค้นหาหนึ่งครั้งนั่นเอง

maxResults

เป็นตัวเลขที่ระบุจำนวนรายการผลลัพธ์ของการค้นหาที่คุณประสงค์จะให้ Google Web API คืนค่าให้คุณ ซึ่งจะมีค่าอยู่ระหว่าง 1 ถึง 10

filter

คุณอาจนึกถึง filter ที่เป็นออปชันซึ่งมีให้เลือกในโปรแกรมที่สามารถกรองข้อมูลไม่ให้เด็กดู แต่จริงๆแล้วค่า true หรือ false ในส่วนนี้จะเป็นการกรองข้อมูลที่ได้จากการค้นหา ให้ผลของการค้นหาที่มีหัวข้อซ้ำกันถูกตัดออกไป โดยเฉพาะอย่างยิ่งที่มาจากโฮสต์ตัวเดียวกัน ซึ่งการ enable ในส่วนของ filter นี้ จะทำให้มีเพียงผลลัพธ์ของการค้นหาเพียงสองรายการแรกในหนึ่งโฮสต์เท่านั้น ที่จะแสดงออกมาในรายการผลลัพธ์ของการค้นหาทั้งหมด

restrict

ในส่วนนี้จะเป็นการจำกัดผลลัพธ์ของการค้นหาของคุณ ให้ตรงกับความต้องการมากยิ่งขึ้น หรืออาจจะเป็นการระบุประเทศที่เป็นแหล่งที่มาของผลลัพธ์ก็ได้ ซึ่ง Google มีการจำกัดในส่วนนี้แบ่งได้เป็น 4 หัวข้อ (Topic) ด้วยกัน คือ US. Government (unclesam), Linux (linux), Macintosh (mac) และ FreeBSD (bsd) ซึ่งสำหรับการจำกัดผลลัพธ์ที่เป็นประเทศนั้น จะมีรายชื่อประเทศพร้อมชื่อย่อใน Google Web API Documentation อยู่แล้ว คุณสามารถนำมาใช้ได้เลย สำหรับการค้นหาที่ไม่ต้องการจำกัดผลลัพธ์ด้วยวิธีนี้ สามารถทำได้โดยเพียงใส่เครื่องหมาย “” ลงไปเท่านั้น

safeSearch

ตรงส่วนนี้จะเป็นการกรองเนื้อหาที่ได้รับ มีค่าให้เลือกใส่เป็นค่าบูลีน true หรือ false ซึ่งจะเป็นการระบุให้ผลลัพธ์ มีการกรองข้อมูลที่ไม่เหมาะสม หรือข้อมูลที่มีเนื้อหาไม่เหมาะสม (questionable content) ออกไป

lr ย่อมาจาก “Language Restrict” ซึ่ง Google มีลิสต์รายการภาษาต่างๆใน Google Web API Documentation อยู่แล้ว คุณสามารถใช้ภาษาเป็นเครื่องมือในการจำกัดผลลัพธ์ได้ หรือถ้าไม่ต้องการทำเช่นนั้น ก็ปล่อยอาร์กิวเมนต์นี้ให้เว้นว่างไว้

ในการจำกัดผลลัพธ์ในการแสดงเป็นภาษาต่างๆนั้น สามารถทำได้หลายวิธี เช่น คุณสามารถใส่รหัสของภาษา (language code) นั้นๆลงไป เช่น สมมุติคุณต้องการจำกัดผลลัพธ์ให้เป็นเฉพาะภาษาอังกฤษเท่านั้น คุณก็เพียงใส่ lang_en ลงไป นอกจากนี้คุณสามารถจำกัดผลลัพธ์ได้มากกว่าหนึ่งภาษา โดยการคั่นรหัสของภาษาที่ต้องการด้วยเครื่องหมาย | (pipe) ตัวอย่างเช่น lang_en|lang_de ซึ่งจะเป็นการจำกัดผลลัพธ์เป็นภาษาอังกฤษหรือเยอรมันเท่านั้น

เพื่อไม่ให้ผลลัพธ์มีข้อความที่คุณไม่เข้าใจ คุณสามารถกำหนดไม่ให้ภาษาอื่นใดที่ไม่ต้องการ หรือไม่เกี่ยวข้องกับสิ่งที่ต้องการค้นหา ปรากฏในผลลัพธ์ได้ด้วย โดยการใส่เครื่องหมาย – (ลบ) นำหน้ารหัสของภาษานั้นๆ เช่น –lang_de จะแสดงผลลัพธ์ของการค้นหาได้ทุกภาษานอกจากภาษาเยอรมันเท่านั้น

อาร์กิวเมนต์ ie ย่อมาจาก “Input Encoding” ซึ่งจะทำให้คุณสามารถระบุ Character Encoding ที่ใช้ในการส่งคำสั่งค้นหาได้ ในเอกสารประกอบ (Documentation) ของ Google แนะนำเอาไว้ว่า “เครื่องที่ติดต่อเข้ามา ควรจะส่ง request มาในรูปแบบ UTF-8 และคาดหวังว่าจะได้รับผลการค้นหาในรูปแบบ UTF-8 กลับไปด้วย” เนื่องจากปัจจุบันนี้ทุกอย่างเป็น UTF-8 ไปเกือบหมดแล้ว และในแง่ปฏิบัติจริงๆแล้ว request ใดที่ไม่ได้ใช้ UTF-8 จะไม่ถูกรับเข้ามาประมวลผลไปโดยปริยายเลยทีเดียว

อาร์กิวเมนต์ตัวนี้ย่อมาจาก “Output Encoding” ซึ่งก็เหมือนกันกับ Input Encoding คือทุกสิ่งทุกอย่างเป็น UTF-8 ไปหมดแล้ว

ตัวอย่าง

คราวนี้เราลองมาดูตัวอย่างกัน สมมุติให้เป็นการส่งคำสั่งค้นหา ที่มีการใช้ตัวแปรแทน key และ query และระบุผลลัพธ์ของการค้นหาที่ต้องการจำนวน 10 รายการ โดยเริ่มต้นจากรายการหมายเลขที่ 100 และมีการกำหนดให้ filter และ safeSearch ทำงาน ซึ่งการค้นหาด้วย Perl จะมีลักษณะดังนี้

my $results = $google_search ->

doGoogleSearch(

$google_key, $query, 100, 10,

"true", "", "true", "",

"utf8", "utf8"

);

โปรดสังเกตว่า key และ query ซึ่งแทนด้วยตัวแปรจะมีเครื่องหมาย “” ครอบอยู่ด้วย

my $results = $google_search ->

doGoogleSearch(

"12BuCK13mY5h0E/34KN0cK@ttH3Do0R", "+paloentology +dentistry" , 100, 10,

"true", "", "true", "",

"utf8", "utf8"

);

การจำกัดผลลัพธ์ของการค้นหา

บางครั้งคุณอาจต้องการจำกัดผลลัพธ์ให้ออกมาเป็นภาษาใดภาษาหนึ่ง และจากประเทศใดประเทศหนึ่งโดยเฉพาะ หรืออาจเป็นภาษา ประเทศและหัวข้อใดหัวข้อหนึ่งโดยเฉพาะ นี่เป็นคำแนะนำหลักทั่วไปเล็กน้อย เกี่ยวกับการจำกัดผลลัพธ์บางประการ

จำกัดไม่ให้มีคำบางคำในผลลัพธ์การค้นหา โดยการใช้เครื่องหมาย - (ลบ) หน้าคำนั้นๆ
แยกประเภทอาร์กิวเมนต์แต่ละประเภทด้วยเครื่องหมาย . (จุด) โดยไม่มีช่องว่างระหว่างคำ เช่น “linux.contryCA” เป็นต้น
ระบุความสัมพันธ์แบบ OR ระหว่างค่าของอาร์กิวเมนต์ 2 ค่าที่เป็นประเภทเดียวกันด้วยเครื่องหมาย | (pipe) เช่น contryCA|contryFR เป็นการเลือกผลลัพธ์ที่มาจากประเทศแคนาดาหรือฝรั่งเศสก็ได้
ครอบค่าของอาร์กิวเมนต์ที่เป็นประเภทเดียวกันด้วยเครื่องหมายวงเล็บ

สมมุติคุณต้องการค้นหาผลลัพธ์เป็นภาษาฝรั่งเศส แต่เป็นผลลัพธ์ที่มาจากเว็บไซต์ในประเทศแคนาดาเท่านั้น รวมทั้งสนใจเฉพาะหัวข้อที่เกี่ยวกับลีนุกซ์อย่างเดียว การค้นหาของคุณจะมีคำสั่งค้นหา ดังนี้

my $results = $google_search ->

doGoogleSearch(

$google_key, $query, 100, 10,

"true", "linux.countryCA", "true", "lang_fr",

"utf8", "utf8"

);

สำหรับการค้นหาผลลัพธ์จากประเทศแคนาดา หรือจากประเทศฝรั่งเศส จะใช้ดังนี้

“.linux.(countryCA|countryFR)”

หรือถ้าหากต้องการผลลัพธ์เป็นภาษาฝรั่งเศสเหมือนเดิม แต่ต้องการให้มาจากเว็บไซต์จากประเทศต่างๆทั่วโลก ยกเว้นแต่เฉพาะประเทศฝรั่งเศสเท่านั้น จะต้องใช้ดังนี้

“.linux.(-countryFR)”

การใส่อาร์กิวเมนต์อื่นๆ

คุณสามารถใช้อาร์กิวเมนต์ตัวอื่นๆได้ดังนี้

การใช้ SafeSearch

ถ้าหากคุณกำลังพัฒนาโปรแกรมสำหรับให้ทุกเพศทุกวัยสามารถใช้ได้ คุณอาจจำเป็นต้องใช้ Safesearch ซึ่งคุณสามารถเข้าไปดูรายละเอียดได้ใน Hack #81 โดยทั่วไปแล้ว คุณสามารถพัฒนาโปรแกรมที่สามารถอ่านข้อความต่างๆในเว็บฟอร์ม เพื่อนำข้อความหรือคำที่อยู่ในนั้นมาตรวจสอบ ว่ามีความเหมาะสมหรือล่อแหลมเพียงใด เพื่อพิจารณาว่าสมควรกรองข้อความหรือคำนั้นออกไปหรือไม่

การตั้งค่าจำนวนผลลัพธ์

ไม่ว่าคุณจะตั้งค่าจำนวนผลลัพธ์เอาไว้ 1 หรือ 10 รายการก็ตาม โปรดทราบว่าคุณได้ใช้สิทธิ์ในการส่งค่าไปยัง Google ที่กำหนดเอาไว้ไม่เกิน 1,000 ครั้ง ตามที่คีย์ของคุณทำได้ในแต่ละวันเท่านั้น คุณอาจจะเกิดคำถามขึ้นมาในใจว่า ถ้าเป็นเช่นนั้นคุณก็ตั้งค่าจำนวนผลลัพธ์ในแต่ละครั้งเอาไว้ที่ 10 รายการเลยไม่ดีกว่าหรือ ซึ่งจริงๆแล้วอาจจะไม่จำเป็นก็ได้ ถ้าหากคุณสนใจเฉพาะผลลัพธ์ที่อยู่ด้านบนสุดของรายการผลลัพธ์ของการค้นหาเท่านั้น ทั้งนี้เนื่องจากการไม่ request ผลลัพธ์ที่คุณไม่สนใจ จะเป็นการเพิ่มความเร็วให้กับโปรแกรมของคุณได้อีกเล็กน้อยด้วย

การค้นหาแบบจำกัดหัวข้อ

ความสามารถของ Google Web API ที่ยอมให้คุณค้นหาผลลัพธ์แบ่งเป็นหัวข้อได้ถึง 4 หัวข้อ ด้วยผลลัพธ์ที่เป็นภาษาหรือประเทศที่แตกต่างกันไปนับสิบประเทศ ดังนั้นจึงอาจเกิดผลลัพธ์ที่ต่างกันได้มากมายนับพัน ที่เราจะเลือกจำกัดให้ได้เฉพาะผลลัพธ์ของหัวข้อ ภาษา และประเทศที่เราสนใจ

ลองพิจารณาดูถึงโปรแกรมที่จำกัดผลลัพธ์เฉพาะเรื่องที่เกี่ยวกับ Open Source เท่านั้น (เช่น linux หรือ perl) ซึ่งคุณอาจจะมีรายการคำศัพท์ที่เกี่ยวข้องกับเรื่อง Open Source เอาไว้ชุดหนึ่ง แล้วพัฒนาโปรแกรมเพื่อให้ค้นหาผลลัพธ์ โดยยึดรายการคำศัพท์ชุดนี้เป็นหลักเพื่อให้ได้ผลลัพธ์ออกมาเกี่ยวกับหัวข้อ Open Source เท่านั้นก็ได้ โดยสามารถจำกัดเฉพาะแหล่งที่มาของผลลัพธ์ว่าต้องการให้มาจากประเทศอะไรได้เหมือนเดิม ซึ่งคุณอาจจะได้ผลลัพธ์ว่า มีการพูดถึงภาษา Perl ในหัวข้อ Linux อยู่จำนวน 15 ครั้งในประเทศฝรั่งเศส และ 20 ครั้งในประเทศเยอรมัน เป็นต้น

คุณอาจจะพัฒนาโปรแกรมที่มีพูลดาวน์เมนู (pull-down menu) เพื่อให้ผู้ใช้สามารถเลือกจำกัดผลลัพธ์ของการค้นหา ว่าจะให้มาจากทวีปใดด้วยก็ได้ คล้ายกับจำกัดผลลัพธ์ที่มาจากประเทศใดประเทศหนึ่งๆนั่นเอง ซึ่งทำได้โดยการใส่ชื่อทวีปลงไปเป็นตัวแปรในการค้นหา หรือแม้กระทั่งการสร้างอินเทอร์เฟสเพื่อให้ผู้ใช้ระบุหัวข้อ (Topic) ใดหัวข้อหนึ่ง แล้วกำหนดให้แสดงผลลัพธ์ออกมา โดยเป็นผลลัพธ์ที่มาจากประเทศต่างๆที่เตรียมไว้ ประเทศหนึ่งต่อผลลัพธ์หนึ่ง หรือจะเป็นภาษาหนึ่งต่อผลลัพธ์รายการหนึ่งก็ได้

ทำความเข้าใจกับ Google Web API Response

ในขณะที่ Google Web API ยอมให้คุณเข้าถึงส่วนที่เป็นหัวใจสำคัญของ Google Index แต่พึงทราบว่ามีบางอย่างที่ทำได้ และบางอย่างก็ทำไม่ได้เหมือนกัน นั่นคือ

สิ่งที่ทำได้

สิ่งที่ Google Web API ทำได้หรือให้การสนับสนุนก็คือ ซินแท็กซ์ดังต่อไปนี้

site:

dasterange:

intitle:

inurl:

allintext:

allinlinks:

filetype:

info:

link:

cache:

สิ่งที่ Google API ทำไม่ได้

ซินแท็กซ์ที่ Google Web API ไม่สนับสนุนก็คือ

phonebook:

rphonebook:

bphonebook:

stocks:

ในขณะที่ซินแท็กซ์เหล่านี้ไม่สามารถให้ผลลัพธ์ได้ภายใต้การทำงานของ Google Web API แต่คุณอาจจะใช้ประโยชน์จากซินแท็กซ์เหล่านี้ได้บ้าง อย่างเช่นที่ไฟล์ kincount.cgi ใน Hack #70 ได้ทำให้ดูเป็นตัวอย่าง

แสดงผลลัพธ์ได้ไม่เกิน 10 รายการ

ในขณะที่การค้นหาผ่านโฮมเพจ Google.com สามารถเลือกแสดงผลลัพธ์ได้ว่าต้องการให้แสดงผลลัพธ์หน้าละ 10,20,30,50 หรือ 100 รายการต่อหนึ่งหน้า แต่ Google Web API จำกัดผลลัพธ์เอาไว้ที่ 10 รายการต่อการค้นหาหนึ่งครั้ง อย่างไรก็ตาม มิได้หมายความว่าคุณไม่สามารถได้ผลลัพธ์มากกว่านี้ได้เลยถ้าต้องการจริงๆ เพราะการเพิ่มผลลัพธ์ให้มากกว่านี้ทำได้ง่ายๆเพียงแค่การใช้การวนลูปดึงผลลัพธ์เพิ่มครั้งละ 10 รายการเท่านั้นเอง [Hack #51]

ผลลัพธ์จะแสดงอะไรบ้าง

Google Web API จะแสดงข้อมูลสรุปเกี่ยวกับรายการผลลัพธ์ทั้งหมด รวมทั้งข้อมูลในส่วนของผลลัพธ์แต่ละรายการด้วย ดังนี้

ข้อมูลสรุป ข้อมูลสรุปเกี่ยวกับรายการผลลัพธ์ทั้งหมดประกอบด้วยดังนี้

<documentFiltering>

ค่า true/false ที่จะเป็นการระบุว่า ผลลัพธ์ที่ได้จากการค้นหานี้ มีการกรองเพื่อคัดแยกผลลัพธ์ที่มีเนื้อหาคล้ายคลึงกันมากๆออกไปหรือไม่ หรืออาจจะเป็นการแยกรายการผลลัพธ์จากโฮสต์ตัวเดียวกันออกไปบางรายการก็ได้

<directoryCategories>

ลิสต์รายการหมวดของไดเรกทอรี (ถ้ามี) รวมทั้งคำถามที่ใช้ค้นหา

ข้อมูลในผลลัพธ์แต่ละรายการ ผลลัพธ์แต่ละรายการจะบอกถึง URL ที่มาของข้อมูล ชื่อเรื่อง (title) รวมถึงข้อความที่ตัดตอนบางส่วนมาจากเนื้อหา (snippet) ด้วย ซึ่งแบ่งออกเป็นส่วนๆดังนี้

<summary>

สรุปรายการไดเรกทอรีของ Google (ถ้ามี)

<URL>

URL ที่เป็นแหล่งที่มาของผลลัพธ์ ซึ่งจะมี http:// นำหน้า

<snippet>

ข้อความที่ตัดตอนมาจากเนื้อหาทั้งหมด ซึ่งจะมีคำที่เราถามหรือใช้ค้นหา แสดงเป็นตัวหนา (แท็ก   ในภาษา HTML)



<title>

ชื่อเรื่อง (title) ในภาษา HTML

<cachedSize>

ขนาดเป็นกิโลไบต์ (kb) ของหน้าที่ทำการแคชไว้ (ถ้ามี)

คุณอาจจะสังเกตเห็นว่า ไม่มี PageRank แสดงในรายการผลลัพธ์แต่ละรายการ ซึ่งจริงๆแล้ว Google จะแสดง PageRank ก็เฉพาะแต่ใน Google Toolbar [Hack #24] เท่านั้น นอกจากใน Google Toolbar แล้ว ก็มีที่ Google Directory ที่จะแสดง PageRank เอาไว้ด้วย