Blame - docs/dyn/customsearch_v1.cse.siterestrict.html - platform/external/python/google-api-python-client

2019-06-14 16:50:42 -0700

[diff] [blame]

76

<h2>Instance Methods</h2>

77

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

78

<code><a href="#list">list(highRange=None, q=None, cr=None, siteSearch=None, dateRestrict=None, siteSearchFilter=None, lr=None, exactTerms=None, relatedSite=None, imgType=None, num=None, safe=None, imgColorType=None, imgSize=None, gl=None, imgDominantColor=None, linkSite=None, excludeTerms=None, googlehost=None, rights=None, cx=None, start=None, filter=None, orTerms=None, hq=None, searchType=None, hl=None, sort=None, fileType=None, lowRange=None, c2coff=None, x__xgafv=None)</a></code></p>

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

79

<p class="firstline">Returns metadata about the search performed, metadata about the custom</p>

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

80

<h3>Method Details</h3>

81

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

82

<code class="details" id="list">list(highRange=None, q=None, cr=None, siteSearch=None, dateRestrict=None, siteSearchFilter=None, lr=None, exactTerms=None, relatedSite=None, imgType=None, num=None, safe=None, imgColorType=None, imgSize=None, gl=None, imgDominantColor=None, linkSite=None, excludeTerms=None, googlehost=None, rights=None, cx=None, start=None, filter=None, orTerms=None, hq=None, searchType=None, hl=None, sort=None, fileType=None, lowRange=None, c2coff=None, x__xgafv=None)</code>

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

83

<pre>Returns metadata about the search performed, metadata about the custom

84

search engine used for the search, and the search results. Uses a small set

85

of url patterns.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

86

87

Args:

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

88

highRange: string, Specifies the ending value for a search range.

89

90

* Use `lowRange` and `highRange` to append an inclusive search range of

91

`lowRange...highRange` to the query.

92

q: string, Query

93

cr: string, Restricts search results to documents originating in a particular country.

94

You may use [Boolean

95

operators](https://developers.google.com/custom-search/docs/xml_results_appendices#booleanOperators)

96

in the cr parameter's value.

97

98

Google Search determines the country of a document by analyzing:

99

100

* the top-level domain (TLD) of the document's URL

101

102

* the geographic location of the Web server's IP address

103

104

See the [Country Parameter

105

Values](https://developers.google.com/custom-search/docs/xml_results_appendices#countryCollections)

106

page for a list of valid values for this parameter.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

107

siteSearch: string, Specifies a given site which should always be included or excluded from

108

results (see `siteSearchFilter` parameter, below).

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

109

dateRestrict: string, Restricts results to URLs based on date. Supported values include:

110

111

* `d[number]`: requests results from the specified number of past days.

112

113

* `w[number]`: requests results from the specified number of past weeks.

114

115

* `m[number]`: requests results from the specified number of past months.

116

117

* `y[number]`: requests results from the specified number of past years.

118

siteSearchFilter: string, Controls whether to include or exclude results from the site named in the

119

`siteSearch` parameter.

120

121

Acceptable values are:

* `"e"`: exclude

* `"i"`: include

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

126

lr: string, Restricts the search to documents written in a particular language (e.g.,

127

`lr=lang_ja`).

128

129

Acceptable values are:

130

131

* `"lang_ar"`: Arabic

132

133

* `"lang_bg"`: Bulgarian

134

135

* `"lang_ca"`: Catalan

* `"lang_cs"`: Czech

* `"lang_da"`: Danish

140

141

* `"lang_de"`: German

* `"lang_el"`: Greek

* `"lang_en"`: English

146

147

* `"lang_es"`: Spanish

148

149

* `"lang_et"`: Estonian

150

151

* `"lang_fi"`: Finnish

152

153

* `"lang_fr"`: French

154

155

* `"lang_hr"`: Croatian

156

157

* `"lang_hu"`: Hungarian

158

159

* `"lang_id"`: Indonesian

160

161

* `"lang_is"`: Icelandic

162

163

* `"lang_it"`: Italian

164

165

* `"lang_iw"`: Hebrew

166

167

* `"lang_ja"`: Japanese

168

169

* `"lang_ko"`: Korean

170

171

* `"lang_lt"`: Lithuanian

172

173

* `"lang_lv"`: Latvian

* `"lang_nl"`: Dutch

* `"lang_no"`: Norwegian

178

179

* `"lang_pl"`: Polish

180

181

* `"lang_pt"`: Portuguese

182

183

* `"lang_ro"`: Romanian

184

185

* `"lang_ru"`: Russian

186

187

* `"lang_sk"`: Slovak

188

189

* `"lang_sl"`: Slovenian

190

191

* `"lang_sr"`: Serbian

192

193

* `"lang_sv"`: Swedish

194

195

* `"lang_tr"`: Turkish

196

197

* `"lang_zh-CN"`: Chinese (Simplified)

198

199

* `"lang_zh-TW"`: Chinese (Traditional)

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

200

exactTerms: string, Identifies a phrase that all documents in the search results must contain.

201

relatedSite: string, Specifies that all search results should be pages that are related to the

202

specified URL.

203

imgType: string, Returns images of a type. Acceptable values are:

* `"clipart"`

* `"face"`

* `"lineart"`

* `"stock"`

* `"photo"`

* `"animated"`

num: integer, Number of search results to return.

217

218

* Valid values are integers between 1 and 10, inclusive.

219

safe: string, Search safety level. Acceptable values are:

220

221

* `"active"`: Enables SafeSearch filtering.

222

223

* `"off"`: Disables SafeSearch filtering. (default)

224

imgColorType: string, Returns black and white, grayscale, transparent, or color images.

225

Acceptable values are:

* `"color"`

* `"gray"`

* `"mono"`: black and white

232

233

* `"trans"`: transparent background

234

imgSize: string, Returns images of a specified size. Acceptable values are:

* `"huge"`

* `"icon"`

* `"large"`

* `"medium"`

* `"small"`

* `"xlarge"`

* `"xxlarge"`

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

249

gl: string, Geolocation of end user.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

250

251

* The `gl` parameter value is a two-letter country code. The `gl` parameter

252

boosts search results whose country of origin matches the parameter value.

253

See the [Country

254

Codes](https://developers.google.com/custom-search/docs/xml_results_appendices#countryCodes)

255

page for a list of valid values.

256

257

* Specifying a `gl` parameter value should lead to more relevant results.

258

This is particularly true for international customers and, even more

259

specifically, for customers in English- speaking countries other than the

260

United States.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

261

imgDominantColor: string, Returns images of a specific dominant color. Acceptable values are:

* `"black"`

* `"blue"`

* `"brown"`

* `"gray"`

* `"green"`

* `"orange"`

* `"pink"`

* `"purple"`

* `"red"`

* `"teal"`

* `"white"`

* `"yellow"`

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

286

linkSite: string, Specifies that all search results should contain a link to a particular

287

URL.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

288

excludeTerms: string, Identifies a word or phrase that should not appear in any documents in the

289

search results.

290

googlehost: string, **Deprecated**. Use the `gl` parameter for a similar effect.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

291

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

292

The local Google domain (for example, google.com, google.de, or

293

google.fr) to use to perform the search.

294

rights: string, Filters based on licensing. Supported values include: `cc_publicdomain`,

295

`cc_attribute`, `cc_sharealike`, `cc_noncommercial`, `cc_nonderived` and

296

combinations of these. See [typical

297

combinations](https://wiki.creativecommons.org/wiki/CC_Search_integration).

298

cx: string, The custom search engine ID to use for this request.

299

start: integer, The index of the first result to return. The default number of results per

300

page is 10, so `&start=11` would start at the top of the second page of

301

results. **Note**: The JSON API will never return more than 100 results,

302

even if more than 100 documents match the query, so setting the sum of

303

`start + num` to a number greater than 100 will produce an error. Also note

304

that the maximum value for `num` is 10.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

305

filter: string, Controls turning on or off the duplicate content filter.

306

307

* See [Automatic

308

Filtering](https://developers.google.com/custom-search/docs/xml_results#automaticFiltering)

309

for more information about Google's search results filters. Note that host

310

crowding filtering applies only to multi-site searches.

311

312

* By default, Google applies filtering to all search results to improve the

313

quality of those results.

314

315

Acceptable values are:

316

317

* `0`: Turns off duplicate content filter.

318

319

* `1`: Turns on duplicate content filter.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

320

orTerms: string, Provides additional search terms to check for in a document, where each

321

document in the search results must contain at least one of the additional

322

search terms.

323

hq: string, Appends the specified query terms to the query, as if they were combined

324

with a logical AND operator.

325

searchType: string, Specifies the search type: `image`. If unspecified, results are limited to

326

webpages.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

327

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

328

Acceptable values are:

329

330

* `"image"`: custom image search.

331

hl: string, Sets the user interface language.

332

333

* Explicitly setting this parameter improves the performance and the

334

quality of your search results.

335

336

* See the [Interface

337

Languages](https://developers.google.com/custom-search/docs/xml_results#wsInterfaceLanguages)

338

section of [Internationalizing Queries and Results

339

Presentation](https://developers.google.com/custom-search/docs/xml_results#wsInternationalizing)

340

for more information, and (Supported Interface

341

Languages)[https://developers.google.com/custom-search/docs/xml_results_appendices#interfaceLanguages]

342

for a list of supported languages.

343

sort: string, The sort expression to apply to the results.

344

fileType: string, Restricts results to files of a specified extension. A list of file types

345

indexable by Google can be found in Search Console [Help

346

Center](https://support.google.com/webmasters/answer/35287).

347

lowRange: string, Specifies the starting value for a search range. Use `lowRange` and

348

`highRange` to append an inclusive search range of `lowRange...highRange`

349

to the query.

350

c2coff: string, Enables or disables [Simplified and Traditional Chinese

351

Search](https://developers.google.com/custom-search/docs/xml_results#chineseSearch).

352

353

The default value for this parameter is 0 (zero), meaning that the feature

354

is enabled. Supported values are:

* `1`: Disabled

* `0`: Enabled (default)

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

359

x__xgafv: string, V1 error format.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

360

Allowed values

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

361

1 - v1 error format

362

2 - v2 error format

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

363

364

Returns:

365

An object of the form:

366

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

367

{ # Response to a custom search request.

368

"queries": { # Query metadata for the previous, current, and next pages of results.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

369

"request": [ # Metadata representing the current request.

370

{ # Custom search request metadata.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

371

"language": "A String", # The language of the search results.

372

"googleHost": "A String", # Specifies the Google domain (for example, google.com, google.de, or

373

# google.fr) to which the search should be limited.

374

"imgSize": "A String", # Restricts results to images of a specified size. Supported values are:

#

# * `icon` (small)

#

# * `small | medium | large | xlarge` (medium)

379

#

380

# * `xxlarge` (large)

381

#

382

# * `huge` (extra-large)

383

"filter": "A String", # Activates or deactivates the automatic filtering of Google search

384

# results. See [Automatic

385

# Filtering](https://developers.google.com/custom-search/docs/xml_results#automaticFiltering)

386

# for more information about Google's search results filters. Valid values

387

# for this parameter are:

#

# * `0`: Disabled

#

# * `1`: Enabled (default)

392

#

393

# **Note**: By default, Google applies filtering to all search results to

394

# improve the quality of those results.

395

"imgDominantColor": "A String", # Restricts results to images with a specific dominant color. Supported

# values are:

#

# * `red`

#

# * `orange`

#

# * `yellow`

#

# * `green`

#

# * `teal`

#

# * `blue`

#

# * `purple`

#

# * `pink`

#

# * `white`

#

# * `gray`

#

# * `black`

#

# * `brown`

"title": "A String", # A description of the query.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

422

"disableCnTwTranslation": "A String", # Enables or disables the [Simplified and Traditional Chinese

423

# Search](https://developers.google.com/custom-search/docs/xml_results#chineseSearch)

424

# feature.

425

#

426

# Supported values are:

427

#

428

# * `0`: enabled (default)

429

#

430

# * `1`: disabled

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

431

"sort": "A String", # Specifies that results should be sorted according to the specified

432

# expression. For example, sort by date.

433

"startPage": 42, # The page number of this set of results, where the page length is set by

434

# the `count` property.

435

"inputEncoding": "A String", # The character encoding supported for search requests.

436

"cx": "A String", # The identifier of a custom search engine created using the Custom Search

437

# [Control Panel](https://cse.google.com/). This is a custom property not

438

# defined in the OpenSearch spec. This parameter is **required**.

439

"gl": "A String", # Boosts search results whose country of origin matches the parameter

440

# value. See [Country

441

# Codes](https://developers.google.com/custom-search/docs/xml_results#countryCodes)

442

# for a list of valid values.

443

#

444

# Specifying a `gl` parameter value in WebSearch requests should improve

445

# the relevance of results. This is particularly true for international

446

# customers and, even more specifically, for customers in English-speaking

447

# countries other than the United States.

448

"excludeTerms": "A String", # Identifies a word or phrase that should not appear in any documents in

449

# the search results.

450

"outputEncoding": "A String", # The character encoding supported for search results.

451

"searchTerms": "A String", # The search terms entered by the user.

452

"highRange": "A String", # Specifies the ending value for a search range. Use `cse:lowRange` and

453

# `cse:highrange` to append an inclusive search range of

454

# `lowRange...highRange` to the query.

455

"siteSearch": "A String", # Restricts results to URLs from a specified site.

456

"hq": "A String", # Appends the specified query terms to the query, as if they were combined

457

# with a logical `AND` operator.

458

"count": 42, # Number of search results returned in this set.

459

"relatedSite": "A String", # Specifies that all search results should be pages that are related to the

460

# specified URL. The parameter value should be a URL.

461

"hl": "A String", # Specifies the interface language (host language) of your user interface.

462

# Explicitly setting this parameter improves the performance and the

463

# quality of your search results.

464

#

465

# See the [Interface

466

# Languages](https://developers.google.com/custom-search/docs/xml_results#wsInterfaceLanguages)

467

# section of [Internationalizing Queries and Results

468

# Presentation](https://developers.google.com/custom-search/docs/xml_results#wsInternationalizing)

469

# for more information, and [Supported Interface

470

# Languages](https://developers.google.com/custom-search/docs/xml_results_appendices#interfaceLanguages)

471

# for a list of supported languages.

472

"totalResults": "A String", # Estimated number of total search results. May not be accurate.

473

"rights": "A String", # Filters based on licensing. Supported values include:

474

#

475

# * `cc_publicdomain`

#

# * `cc_attribute`

#

# * `cc_sharealike`

#

# * `cc_noncommercial`

482

#

483

# * `cc_nonderived`

484

"cr": "A String", # Restricts search results to documents originating in a particular

485

# country. You may use [Boolean

486

# operators](https://developers.google.com/custom-search/docs/xml_results#booleanOperators)

487

# in the `cr` parameter's value.

488

#

489

# Google WebSearch determines the country of a document by analyzing the

490

# following:

491

#

492

# * The top-level domain (TLD) of the document's URL.

493

#

494

# * The geographic location of the web server's IP address.

495

#

496

# See [Country (cr) Parameter

497

# Values](https://developers.google.com/custom-search/docs/xml_results#countryCollections)

498

# for a list of valid values for this parameter.

499

"imgColorType": "A String", # Restricts results to images of a specified color type. Supported values

500

# are:

501

#

502

# * `mono` (black and white)

503

#

504

# * `gray` (grayscale)

505

#

506

# * `color` (color)

507

"safe": "A String", # Specifies the [SafeSearch

508

# level](https://developers.google.com/custom-search/docs/xml_results#safeSearchLevels)

509

# used for filtering out adult results. This is a custom property not

510

# defined in the OpenSearch spec. Valid parameter values are:

511

#

512

# * `"off"`: Disable SafeSearch

513

#

514

# * `"active"`: Enable SafeSearch

515

"dateRestrict": "A String", # Restricts results to URLs based on date. Supported values include:

516

#

517

# * `d[number]`: requests results from the specified number of past days.

518

#

519

# * `w[number]`: requests results from the specified number of past weeks.

520

#

521

# * `m[number]`: requests results from the specified number of past months.

522

#

523

# * `y[number]`: requests results from the specified number of past years.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

524

"fileType": "A String", # Restricts results to files of a specified extension. Filetypes supported

525

# by Google include:

526

#

527

# * Adobe Portable Document Format (`pdf`)

528

#

529

# * Adobe PostScript (`ps`)

530

#

531

# * Lotus 1-2-3 (`wk1`, `wk2`, `wk3`, `wk4`, `wk5`, `wki`, `wks`, `wku`)

532

#

533

# * Lotus WordPro (`lwp`)

#

# * Macwrite (`mw`)

#

# * Microsoft Excel (`xls`)

538

#

539

# * Microsoft PowerPoint (`ppt`)

540

#

541

# * Microsoft Word (`doc`)

542

#

543

# * Microsoft Works (`wks`, `wps`, `wdb`)

544

#

545

# * Microsoft Write (`wri`)

546

#

547

# * Rich Text Format (`rtf`)

548

#

549

# * Shockwave Flash (`swf`)

550

#

551

# * Text (`ans`, `txt`).

552

#

553

# Additional filetypes may be added in the future. An up-to-date list can

554

# always be found in Google's [file type

555

# FAQ](https://support.google.com/webmasters/answer/35287).

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

556

"searchType": "A String", # Allowed values are `web` or `image`. If unspecified, results are limited

557

# to webpages.

558

"imgType": "A String", # Restricts results to images of a specified type. Supported values are:

559

#

560

# * `clipart` (Clip art)

#

# * `face` (Face)

#

# * `lineart` (Line drawing)

#

# * `photo` (Photo)

#

# * `animated` (Animated)

569

#

570

# * `stock` (Stock)

571

"linkSite": "A String", # Specifies that all results should contain a link to a specific URL.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

572

"siteSearchFilter": "A String", # Specifies whether to include or exclude results from the site named in

573

# the `sitesearch` parameter. Supported values are:

574

#

575

# * `i`: include content from site

576

#

577

# * `e`: exclude content from site

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

578

"startIndex": 42, # The index of the current set of search results into the total set of

579

# results, where the index of the first result is 1.

580

"lowRange": "A String", # Specifies the starting value for a search range. Use `cse:lowRange` and

581

# `cse:highrange` to append an inclusive search range of

582

# `lowRange...highRange` to the query.

583

"exactTerms": "A String", # Identifies a phrase that all documents in the search results must

584

# contain.

585

"orTerms": "A String", # Provides additional search terms to check for in a document, where each

586

# document in the search results must contain at least one of the

587

# additional search terms. You can also use the [Boolean

588

# OR](https://developers.google.com/custom-search/docs/xml_results#BooleanOrqt)

589

# query term for this type of query.

590

},

591

],

592

"nextPage": [ # Metadata representing the next page of results, if applicable.

593

{ # Custom search request metadata.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

594

"gl": "A String", # Boosts search results whose country of origin matches the parameter

595

# value. See [Country

596

# Codes](https://developers.google.com/custom-search/docs/xml_results#countryCodes)

597

# for a list of valid values.

598

#

599

# Specifying a `gl` parameter value in WebSearch requests should improve

600

# the relevance of results. This is particularly true for international

601

# customers and, even more specifically, for customers in English-speaking

602

# countries other than the United States.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

603

"safe": "A String", # Specifies the [SafeSearch

604

# level](https://developers.google.com/custom-search/docs/xml_results#safeSearchLevels)

605

# used for filtering out adult results. This is a custom property not

606

# defined in the OpenSearch spec. Valid parameter values are:

607

#

608

# * `"off"`: Disable SafeSearch

609

#

610

# * `"active"`: Enable SafeSearch

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

611

"language": "A String", # The language of the search results.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

612

"hl": "A String", # Specifies the interface language (host language) of your user interface.

613

# Explicitly setting this parameter improves the performance and the

614

# quality of your search results.

615

#

616

# See the [Interface

617

# Languages](https://developers.google.com/custom-search/docs/xml_results#wsInterfaceLanguages)

618

# section of [Internationalizing Queries and Results

619

# Presentation](https://developers.google.com/custom-search/docs/xml_results#wsInternationalizing)

620

# for more information, and [Supported Interface

621

# Languages](https://developers.google.com/custom-search/docs/xml_results_appendices#interfaceLanguages)

622

# for a list of supported languages.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

623

"excludeTerms": "A String", # Identifies a word or phrase that should not appear in any documents in

624

# the search results.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

625

"filter": "A String", # Activates or deactivates the automatic filtering of Google search

626

# results. See [Automatic

627

# Filtering](https://developers.google.com/custom-search/docs/xml_results#automaticFiltering)

628

# for more information about Google's search results filters. Valid values

629

# for this parameter are:

#

# * `0`: Disabled

#

# * `1`: Enabled (default)

634

#

635

# **Note**: By default, Google applies filtering to all search results to

636

# improve the quality of those results.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

637

"title": "A String", # A description of the query.

638

"dateRestrict": "A String", # Restricts results to URLs based on date. Supported values include:

639

#

640

# * `d[number]`: requests results from the specified number of past days.

641

#

642

# * `w[number]`: requests results from the specified number of past weeks.

643

#

644

# * `m[number]`: requests results from the specified number of past months.

645

#

646

# * `y[number]`: requests results from the specified number of past years.

647

"highRange": "A String", # Specifies the ending value for a search range. Use `cse:lowRange` and

648

# `cse:highrange` to append an inclusive search range of

649

# `lowRange...highRange` to the query.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

650

"sort": "A String", # Specifies that results should be sorted according to the specified

651

# expression. For example, sort by date.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

652

"relatedSite": "A String", # Specifies that all search results should be pages that are related to the

653

# specified URL. The parameter value should be a URL.

654

"orTerms": "A String", # Provides additional search terms to check for in a document, where each

655

# document in the search results must contain at least one of the

656

# additional search terms. You can also use the [Boolean

657

# OR](https://developers.google.com/custom-search/docs/xml_results#BooleanOrqt)

658

# query term for this type of query.

659

"searchTerms": "A String", # The search terms entered by the user.

660

"outputEncoding": "A String", # The character encoding supported for search results.

661

"imgType": "A String", # Restricts results to images of a specified type. Supported values are:

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

662

#

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

663

# * `clipart` (Clip art)

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

664

#

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

665

# * `face` (Face)

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

666

#

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

667

# * `lineart` (Line drawing)

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

668

#

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

669

# * `photo` (Photo)

670

#

671

# * `animated` (Animated)

672

#

673

# * `stock` (Stock)

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

674

"imgDominantColor": "A String", # Restricts results to images with a specific dominant color. Supported

# values are:

#

# * `red`

#

# * `orange`

#

# * `yellow`

#

# * `green`

#

# * `teal`

#

# * `blue`

#

# * `purple`

#

# * `pink`

#

# * `white`

#

# * `gray`

#

# * `black`

#

# * `brown`

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

700

"hq": "A String", # Appends the specified query terms to the query, as if they were combined

701

# with a logical `AND` operator.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

702

"count": 42, # Number of search results returned in this set.

703

"startPage": 42, # The page number of this set of results, where the page length is set by

704

# the `count` property.

705

"startIndex": 42, # The index of the current set of search results into the total set of

706

# results, where the index of the first result is 1.

707

"cx": "A String", # The identifier of a custom search engine created using the Custom Search

708

# [Control Panel](https://cse.google.com/). This is a custom property not

709

# defined in the OpenSearch spec. This parameter is **required**.

710

"exactTerms": "A String", # Identifies a phrase that all documents in the search results must

711

# contain.

712

"linkSite": "A String", # Specifies that all results should contain a link to a specific URL.

713

"imgColorType": "A String", # Restricts results to images of a specified color type. Supported values

714

# are:

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

715

#

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

716

# * `mono` (black and white)

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

717

#

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

718

# * `gray` (grayscale)

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

719

#

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

720

# * `color` (color)

721

"siteSearchFilter": "A String", # Specifies whether to include or exclude results from the site named in

722

# the `sitesearch` parameter. Supported values are:

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

723

#

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

724

# * `i`: include content from site

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

725

#

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

726

# * `e`: exclude content from site

727

"inputEncoding": "A String", # The character encoding supported for search requests.

728

"cr": "A String", # Restricts search results to documents originating in a particular

729

# country. You may use [Boolean

730

# operators](https://developers.google.com/custom-search/docs/xml_results#booleanOperators)

731

# in the `cr` parameter's value.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

732

#

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

733

# Google WebSearch determines the country of a document by analyzing the

734

# following:

735

#

736

# * The top-level domain (TLD) of the document's URL.

737

#

738

# * The geographic location of the web server's IP address.

739

#

740

# See [Country (cr) Parameter

741

# Values](https://developers.google.com/custom-search/docs/xml_results#countryCollections)

742

# for a list of valid values for this parameter.

743

"rights": "A String", # Filters based on licensing. Supported values include:

744

#

745

# * `cc_publicdomain`

#

# * `cc_attribute`

#

# * `cc_sharealike`

#

# * `cc_noncommercial`

752

#

753

# * `cc_nonderived`

754

"imgSize": "A String", # Restricts results to images of a specified size. Supported values are:

#

# * `icon` (small)

#

# * `small | medium | large | xlarge` (medium)

759

#

760

# * `xxlarge` (large)

761

#

762

# * `huge` (extra-large)

763

"siteSearch": "A String", # Restricts results to URLs from a specified site.

764

"disableCnTwTranslation": "A String", # Enables or disables the [Simplified and Traditional Chinese

765

# Search](https://developers.google.com/custom-search/docs/xml_results#chineseSearch)

766

# feature.

767

#

768

# Supported values are:

769

#

770

# * `0`: enabled (default)

771

#

772

# * `1`: disabled

773

"searchType": "A String", # Allowed values are `web` or `image`. If unspecified, results are limited

774

# to webpages.

775

"lowRange": "A String", # Specifies the starting value for a search range. Use `cse:lowRange` and

776

# `cse:highrange` to append an inclusive search range of

777

# `lowRange...highRange` to the query.

778

"googleHost": "A String", # Specifies the Google domain (for example, google.com, google.de, or

779

# google.fr) to which the search should be limited.

780

"fileType": "A String", # Restricts results to files of a specified extension. Filetypes supported

781

# by Google include:

782

#

783

# * Adobe Portable Document Format (`pdf`)

784

#

785

# * Adobe PostScript (`ps`)

786

#

787

# * Lotus 1-2-3 (`wk1`, `wk2`, `wk3`, `wk4`, `wk5`, `wki`, `wks`, `wku`)

788

#

789

# * Lotus WordPro (`lwp`)

#

# * Macwrite (`mw`)

#

# * Microsoft Excel (`xls`)

794

#

795

# * Microsoft PowerPoint (`ppt`)

796

#

797

# * Microsoft Word (`doc`)

798

#

799

# * Microsoft Works (`wks`, `wps`, `wdb`)

800

#

801

# * Microsoft Write (`wri`)

802

#

803

# * Rich Text Format (`rtf`)

804

#

805

# * Shockwave Flash (`swf`)

806

#

807

# * Text (`ans`, `txt`).

808

#

809

# Additional filetypes may be added in the future. An up-to-date list can

810

# always be found in Google's [file type

811

# FAQ](https://support.google.com/webmasters/answer/35287).

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

812

"totalResults": "A String", # Estimated number of total search results. May not be accurate.

813

},

814

],

815

"previousPage": [ # Metadata representing the previous page of results, if applicable.

816

{ # Custom search request metadata.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

817

"safe": "A String", # Specifies the [SafeSearch

818

# level](https://developers.google.com/custom-search/docs/xml_results#safeSearchLevels)

819

# used for filtering out adult results. This is a custom property not

820

# defined in the OpenSearch spec. Valid parameter values are:

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

821

#

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

822

# * `"off"`: Disable SafeSearch

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

823

#

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

824

# * `"active"`: Enable SafeSearch

825

"rights": "A String", # Filters based on licensing. Supported values include:

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

826

#

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

827

# * `cc_publicdomain`

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

828

#

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

829

# * `cc_attribute`

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

830

#

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

831

# * `cc_sharealike`

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

832

#

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

833

# * `cc_noncommercial`

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

834

#

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

835

# * `cc_nonderived`

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

836

"googleHost": "A String", # Specifies the Google domain (for example, google.com, google.de, or

837

# google.fr) to which the search should be limited.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

838

"sort": "A String", # Specifies that results should be sorted according to the specified

839

# expression. For example, sort by date.

840

"orTerms": "A String", # Provides additional search terms to check for in a document, where each

841

# document in the search results must contain at least one of the

842

# additional search terms. You can also use the [Boolean

843

# OR](https://developers.google.com/custom-search/docs/xml_results#BooleanOrqt)

844

# query term for this type of query.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

845

"startIndex": 42, # The index of the current set of search results into the total set of

846

# results, where the index of the first result is 1.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

847

"startPage": 42, # The page number of this set of results, where the page length is set by

848

# the `count` property.

849

"searchType": "A String", # Allowed values are `web` or `image`. If unspecified, results are limited

850

# to webpages.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

851

"fileType": "A String", # Restricts results to files of a specified extension. Filetypes supported

852

# by Google include:

853

#

854

# * Adobe Portable Document Format (`pdf`)

855

#

856

# * Adobe PostScript (`ps`)

857

#

858

# * Lotus 1-2-3 (`wk1`, `wk2`, `wk3`, `wk4`, `wk5`, `wki`, `wks`, `wku`)

859

#

860

# * Lotus WordPro (`lwp`)

#

# * Macwrite (`mw`)

#

# * Microsoft Excel (`xls`)

865

#

866

# * Microsoft PowerPoint (`ppt`)

867

#

868

# * Microsoft Word (`doc`)

869

#

870

# * Microsoft Works (`wks`, `wps`, `wdb`)

871

#

872

# * Microsoft Write (`wri`)

873

#

874

# * Rich Text Format (`rtf`)

875

#

876

# * Shockwave Flash (`swf`)

877

#

878

# * Text (`ans`, `txt`).

879

#

880

# Additional filetypes may be added in the future. An up-to-date list can

881

# always be found in Google's [file type

882

# FAQ](https://support.google.com/webmasters/answer/35287).

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

883

"imgSize": "A String", # Restricts results to images of a specified size. Supported values are:

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

884

#

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

885

# * `icon` (small)

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

886

#

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

887

# * `small | medium | large | xlarge` (medium)

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

888

#

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

889

# * `xxlarge` (large)

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

890

#

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

891

# * `huge` (extra-large)

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

892

"cr": "A String", # Restricts search results to documents originating in a particular

893

# country. You may use [Boolean

894

# operators](https://developers.google.com/custom-search/docs/xml_results#booleanOperators)

895

# in the `cr` parameter's value.

896

#

897

# Google WebSearch determines the country of a document by analyzing the

898

# following:

899

#

900

# * The top-level domain (TLD) of the document's URL.

901

#

902

# * The geographic location of the web server's IP address.

903

#

904

# See [Country (cr) Parameter

905

# Values](https://developers.google.com/custom-search/docs/xml_results#countryCollections)

906

# for a list of valid values for this parameter.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

907

"disableCnTwTranslation": "A String", # Enables or disables the [Simplified and Traditional Chinese

908

# Search](https://developers.google.com/custom-search/docs/xml_results#chineseSearch)

909

# feature.

910

#

911

# Supported values are:

912

#

913

# * `0`: enabled (default)

914

#

915

# * `1`: disabled

916

"imgColorType": "A String", # Restricts results to images of a specified color type. Supported values

917

# are:

918

#

919

# * `mono` (black and white)

920

#

921

# * `gray` (grayscale)

922

#

923

# * `color` (color)

924

"highRange": "A String", # Specifies the ending value for a search range. Use `cse:lowRange` and

925

# `cse:highrange` to append an inclusive search range of

926

# `lowRange...highRange` to the query.

927

"excludeTerms": "A String", # Identifies a word or phrase that should not appear in any documents in

928

# the search results.

929

"count": 42, # Number of search results returned in this set.

930

"title": "A String", # A description of the query.

931

"searchTerms": "A String", # The search terms entered by the user.

932

"filter": "A String", # Activates or deactivates the automatic filtering of Google search

933

# results. See [Automatic

934

# Filtering](https://developers.google.com/custom-search/docs/xml_results#automaticFiltering)

935

# for more information about Google's search results filters. Valid values

936

# for this parameter are:

#

# * `0`: Disabled

#

# * `1`: Enabled (default)

941

#

942

# **Note**: By default, Google applies filtering to all search results to

943

# improve the quality of those results.

944

"language": "A String", # The language of the search results.

945

"lowRange": "A String", # Specifies the starting value for a search range. Use `cse:lowRange` and

946

# `cse:highrange` to append an inclusive search range of

947

# `lowRange...highRange` to the query.

948

"imgType": "A String", # Restricts results to images of a specified type. Supported values are:

949

#

950

# * `clipart` (Clip art)

#

# * `face` (Face)

#

# * `lineart` (Line drawing)

#

# * `photo` (Photo)

#

# * `animated` (Animated)

959

#

960

# * `stock` (Stock)

961

"hl": "A String", # Specifies the interface language (host language) of your user interface.

962

# Explicitly setting this parameter improves the performance and the

963

# quality of your search results.

964

#

965

# See the [Interface

966

# Languages](https://developers.google.com/custom-search/docs/xml_results#wsInterfaceLanguages)

967

# section of [Internationalizing Queries and Results

968

# Presentation](https://developers.google.com/custom-search/docs/xml_results#wsInternationalizing)

969

# for more information, and [Supported Interface

970

# Languages](https://developers.google.com/custom-search/docs/xml_results_appendices#interfaceLanguages)

971

# for a list of supported languages.

972

"outputEncoding": "A String", # The character encoding supported for search results.

973

"gl": "A String", # Boosts search results whose country of origin matches the parameter

974

# value. See [Country

975

# Codes](https://developers.google.com/custom-search/docs/xml_results#countryCodes)

976

# for a list of valid values.

977

#

978

# Specifying a `gl` parameter value in WebSearch requests should improve

979

# the relevance of results. This is particularly true for international

980

# customers and, even more specifically, for customers in English-speaking

981

# countries other than the United States.

982

"siteSearch": "A String", # Restricts results to URLs from a specified site.

983

"hq": "A String", # Appends the specified query terms to the query, as if they were combined

984

# with a logical `AND` operator.

985

"siteSearchFilter": "A String", # Specifies whether to include or exclude results from the site named in

986

# the `sitesearch` parameter. Supported values are:

987

#

988

# * `i`: include content from site

989

#

990

# * `e`: exclude content from site

991

"relatedSite": "A String", # Specifies that all search results should be pages that are related to the

992

# specified URL. The parameter value should be a URL.

993

"linkSite": "A String", # Specifies that all results should contain a link to a specific URL.

994

"totalResults": "A String", # Estimated number of total search results. May not be accurate.

995

"dateRestrict": "A String", # Restricts results to URLs based on date. Supported values include:

996

#

997

# * `d[number]`: requests results from the specified number of past days.

998

#

999

# * `w[number]`: requests results from the specified number of past weeks.

1000

#

1001

# * `m[number]`: requests results from the specified number of past months.

1002

#

1003

# * `y[number]`: requests results from the specified number of past years.

1004

"imgDominantColor": "A String", # Restricts results to images with a specific dominant color. Supported

# values are:

#

# * `red`

#

# * `orange`

#

# * `yellow`

#

# * `green`

#

# * `teal`

#

# * `blue`

#

# * `purple`

#

# * `pink`

#

# * `white`

#

# * `gray`

#

# * `black`

#

# * `brown`

"exactTerms": "A String", # Identifies a phrase that all documents in the search results must

1031

# contain.

1032

"inputEncoding": "A String", # The character encoding supported for search requests.

1033

"cx": "A String", # The identifier of a custom search engine created using the Custom Search

1034

# [Control Panel](https://cse.google.com/). This is a custom property not

1035

# defined in the OpenSearch spec. This parameter is **required**.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1036

},

1037

],

1038

},

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

1039

"url": { # OpenSearch template and URL.

1040

"type": "A String", # The MIME type of the OpenSearch URL template for the Custom Search API.

1041

"template": "A String", # The actual [OpenSearch

1042

# template](http://www.opensearch.org/specifications/opensearch/1.1#opensearch_url_template_syntax)

1043

# for this API.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1044

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1045

"context": { # Metadata and refinements associated with the given search engine,

1046

# including:

1047

#

1048

# * The name of the search engine that was used for the query.

1049

#

1050

# * A set of [facet

1051

# objects](https://developers.google.com/custom-search/docs/refinements#create)

1052

# (refinements) you can use for refining a search.

1053

"a_key": "", # Properties of the object.

1054

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1055

"kind": "A String", # Unique identifier for the type of current object. For this API, it is

1056

# customsearch#search.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

1057

"promotions": [ # The set of

1058

# [promotions](https://developers.google.com/custom-search/docs/promotions).

1059

# Present only if the custom search engine's configuration files define any

1060

# promotions for the given query.

1061

{ # Promotion result.

1062

"title": "A String", # The title of the promotion.

1063

"htmlTitle": "A String", # The title of the promotion, in HTML.

1064

"link": "A String", # The URL of the promotion.

1065

"displayLink": "A String", # An abridged version of this search's result URL, e.g. www.example.com.

1066

"bodyLines": [ # An array of block objects for this promotion. See [Google WebSearch

1067

# Protocol

1068

# reference](https://developers.google.com/custom-search/docs/xml_results)

1069

# for more information.

1070

{ # Block object belonging to a promotion.

1071

"title": "A String", # The block object's text, if it has text.

1072

"htmlTitle": "A String", # The block object's text in HTML, if it has text.

1073

"url": "A String", # The URL of the block object's link, if it has one.

1074

"link": "A String", # The anchor text of the block object's link, if it has a link.

1075

},

1076

],

1077

"image": { # Image belonging to a promotion.

1078

"source": "A String", # URL of the image for this promotion link.

1079

"height": 42, # Image height in pixels.

1080

"width": 42, # Image width in pixels.

},

},

],

"searchInformation": { # Metadata about a search operation.

1085

"totalResults": "A String", # The total number of search results returned by the query.

1086

"formattedTotalResults": "A String", # The total number of search results, formatted according to locale style.

1087

"formattedSearchTime": "A String", # The time taken for the server to return search results, formatted

1088

# according to locale style.

1089

"searchTime": 3.14, # The time taken for the server to return search results.

1090

},

1091

"items": [ # The current set of custom search results.

1092

{ # A custom search result.

1093

"fileFormat": "A String", # The file format of the search result.

1094

"image": { # Image belonging to a custom search result.

1095

"thumbnailWidth": 42, # The width of the thumbnail image, in pixels.

1096

"width": 42, # The width of the image, in pixels.

1097

"contextLink": "A String", # A URL pointing to the webpage hosting the image.

1098

"byteSize": 42, # The size of the image, in pixels.

1099

"thumbnailHeight": 42, # The height of the thumbnail image, in pixels.

1100

"height": 42, # The height of the image, in pixels.

1101

"thumbnailLink": "A String", # A URL to the thumbnail image.

1102

},

1103

"formattedUrl": "A String", # The URL displayed after the snippet for each search result.

1104

"mime": "A String", # The MIME type of the search result.

1105

"displayLink": "A String", # An abridged version of this search result’s URL, e.g. www.example.com.

1106

"cacheId": "A String", # Indicates the ID of Google's cached version of the search result.

1107

"htmlTitle": "A String", # The title of the search result, in HTML.

1108

"snippet": "A String", # The snippet of the search result, in plain text.

1109

"labels": [ # Encapsulates all information about [refinement

1110

# labels](https://developers.google.com/custom-search/docs/xml_results).

1111

{ # Refinement label associated with a custom search result.

1112

"displayName": "A String", # The display name of a refinement label. This is the name you should

1113

# display in your user interface.

1114

"name": "A String", # The name of a refinement label, which you can use to refine searches.

1115

# Don't display this in your user interface; instead, use displayName.

1116

"label_with_op": "A String", # Refinement label and the associated refinement operation.

1117

},

1118

],

1119

"title": "A String", # The title of the search result, in plain text.

1120

"link": "A String", # The full URL to which the search result is pointing, e.g.

1121

# http://www.example.com/foo/bar.

1122

"htmlSnippet": "A String", # The snippet of the search result, in HTML.

1123

"htmlFormattedUrl": "A String", # The HTML-formatted URL displayed after the snippet for each search result.

1124

"kind": "A String", # A unique identifier for the type of current object. For this API, it is

1125

# `customsearch#result.`

1126

"pagemap": { # Contains

1127

# [PageMap](https://developers.google.com/custom-search/docs/structured_data#pagemaps)

1128

# information for this search result.

1129

"a_key": "", # Properties of the object.

},

},

],

"spelling": { # Spell correction information for a query.

1134

"correctedQuery": "A String", # The corrected query.

1135

"htmlCorrectedQuery": "A String", # The corrected query, formatted in HTML.

1136

},

Bu Sun Kim