Method: googleAdsFields.search

แสดงช่องทั้งหมดที่ตรงกับคำค้นหา

รายการข้อผิดพลาด: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError

คำขอ HTTP

POST https://googleads.googleapis.com/v16/googleAdsFields:search

URL ใช้ไวยากรณ์การแปลง gRPC

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "query": string,
  "pageToken": string,
  "pageSize": integer
}
ช่อง
query

string

ต้องระบุ สตริงการค้นหา
pageToken

string

โทเค็นของหน้าที่จะดึงข้อมูล หากไม่ได้ระบุ ระบบจะแสดงผลหน้าแรกของผลการค้นหา ใช้ค่าที่ได้รับจาก nextPageToken ในคำตอบก่อนหน้าเพื่อขอผลลัพธ์หน้าถัดไป
pageSize

integer

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

เนื้อหาการตอบกลับ

ข้อความตอบกลับสำหรับ GoogleAdsFieldService.SearchGoogleAdsFields

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "results": [
    {
      object (GoogleAdsField)
    }
  ],
  "nextPageToken": string,
  "totalResultsCount": string
}
ช่อง
results[]

object (GoogleAdsField)

รายการช่องที่ตรงกับคำค้นหา
nextPageToken

string

โทเค็นการใส่เลขหน้าที่ใช้ในการเรียกผลลัพธ์หน้าถัดไป ส่งเนื้อหาของสตริงนี้เป็นแอตทริบิวต์ pageToken ของคำขอถัดไป nextPageToken ไม่แสดงผลสำหรับหน้าสุดท้าย
totalResultsCount

string (int64 format)

จำนวนผลลัพธ์ทั้งหมดที่ตรงกับข้อความค้นหาโดยไม่คำนึงถึงข้อความ LIMIT

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/adwords

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0