همه ردیفهایی را که با عبارت جستجوی جریان جستجو مطابقت دارند، برمیگرداند.
لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError ChangeEventError ChangeStatusError ClickViewError HeaderError داخلی خطا QueryError QuotaError RequestError
درخواست HTTP
POST https://googleads.googleapis.com/v14/customers/{customerId}/googleAds:searchStream
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
customerId | ضروری. شناسه مشتری مورد سوال |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"query": string,
"summaryRowSetting": enum ( |
زمینه های | |
---|---|
query | ضروری. رشته پرس و جو. |
summaryRowSetting | تعیین می کند که آیا یک ردیف خلاصه بازگردانده می شود یا خیر. به طور پیش فرض، ردیف خلاصه برگردانده نمی شود. در صورت درخواست، ردیف خلاصه پس از بازگرداندن سایر نتایج پرس و جو، خود به خود در پاسخ ارسال می شود. |
بدن پاسخگو
پیام پاسخ برای GoogleAdsService.SearchStream
.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "results": [ { object ( |
زمینه های | |
---|---|
results[] | لیست ردیف هایی که با پرس و جو مطابقت دارند. |
fieldMask | FieldMask که نشان می دهد چه فیلدهایی توسط کاربر درخواست شده است. این فهرستی از نامهای فیلدهای کاملاً واجد شرایط با کاما است. مثال: |
summaryRow | ردیف خلاصه که شامل خلاصه معیارها در نتایج است. خلاصه معیارها به معنای تجمیع معیارها در همه نتایج است، در اینجا تجمیع می تواند مجموع، میانگین، نرخ و غیره باشد. |
requestId | شناسه منحصر به فرد درخواست که برای اهداف اشکال زدایی استفاده می شود. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/adwords
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.