Package google.ads.searchads360.v0.services

شاخص

CustomColumnService

سرویس برای مدیریت ستون های سفارشی.

GetCustomColumn

rpc GetCustomColumn( GetCustomColumnRequest ) returns ( CustomColumn )

ستون سفارشی درخواستی را با جزئیات کامل برمی گرداند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/doubleclicksearch
ListCustomColumns

rpc ListCustomColumns( ListCustomColumnsRequest ) returns ( ListCustomColumnsResponse )

تمام ستون های سفارشی مرتبط با مشتری را با جزئیات کامل برمی گرداند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

خدمات مشتری

خدمات مدیریت مشتریان

لیست مشتریان قابل دسترسی

rpc ListAccessibleCustomers( ListAccessibleCustomersRequest ) returns ( ListAccessibleCustomersResponse )

نام منابع مشتریان را برمی‌گرداند که مستقیماً توسط کاربر احراز هویت تماس قابل دسترسی است.

لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError HeaderError داخلی خطا QuotaError RequestError

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

SearchAds360FieldService

خدماتی برای واکشی فیلدهای Search Ads 360 API.

GetSearchAds360Field

rpc GetSearchAds360Field( GetSearchAds360FieldRequest ) returns ( SearchAds360Field )

فقط فیلد درخواستی را برمی گرداند.

لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError HeaderError داخلی خطا QuotaError RequestError

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/doubleclicksearch
SearchSearchAds360Fields

rpc SearchSearchAds360Fields( SearchSearchAds360FieldsRequest ) returns ( SearchSearchAds360FieldsResponse )

همه فیلدهایی که با عبارت جستجو مطابقت دارند را برمی گرداند.

لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError HeaderError داخلی خطا QueryError QuotaError RequestError

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

SearchAds360 Service

سرویس برای واکشی داده ها و معیارها در منابع.

جستجو کنید

rpc Search( SearchSearchAds360Request ) returns ( SearchSearchAds360Response )

همه ردیف‌هایی را که با عبارت جستجو مطابقت دارند برمی‌گرداند.

لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError HeaderError داخلی خطا QueryError QuotaError RequestError

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/doubleclicksearch
SearchStream

rpc SearchStream( SearchSearchAds360StreamRequest ) returns ( SearchSearchAds360StreamResponse )

همه ردیف‌هایی را که با عبارت جستجوی جریان جستجو مطابقت دارند، برمی‌گرداند.

لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError HeaderError داخلی خطا QueryError QuotaError RequestError

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

ConversionCustomDimensionHeader

پیام برای تبدیل هدر ابعاد سفارشی.

فیلدها
id

int64

شناسه ابعاد سفارشی تبدیل.

name

string

نام تعریف شده توسط کاربر برای بعد سفارشی تبدیل.

ConversionCustomMetricHeader

پیام برای تبدیل هدر متریک سفارشی.

فیلدها
id

int64

شناسه متریک سفارشی تبدیل.

name

string

نام متریک سفارشی تبدیل توسط کاربر تعریف شده است.

CustomColumnHeader

پیام برای سرصفحه ستون سفارشی.

فیلدها
id

int64

شناسه ستون سفارشی

name

string

نام ستون سفارشی توسط کاربر تعریف شده است.

references_ metrics

bool

زمانی درست است که ستون سفارشی به معیارها اشاره کند.

GetCustomColumnRequest

درخواست پیام برای CustomColumnService.GetCustomColumn .

فیلدها
resource_ name

string

مورد نیاز. نام منبع ستون سفارشی برای واکشی.

GetSearchAds360FieldRequest

درخواست پیام برای SearchAds360FieldService.GetSearchAds360Field .

فیلدها
resource_ name

string

مورد نیاز. نام منبع فیلد برای دریافت.

ListAccessibleCustomers Request

این نوع هیچ فیلدی ندارد.

درخواست پیام برای CustomerService.ListAccessibleCustomers .

ListAccessibleCustomers Response

پیام پاسخ برای CustomerService.ListAccessibleCustomers .

فیلدها
resource_ names[]

string

نام منبع مشتریان به طور مستقیم توسط کاربر احراز هویت تماس قابل دسترسی است.

ListCustomColumnsRequest

درخواست پیام برای CustomColumnService.ListCustomColumns

فیلدها
customer_ id

string

مورد نیاز. شناسه مشتری برای اعمال عملیات فهرست CustomColumn.

ListCustomColumnsResponse

پیام پاسخ برای واکشی تمام ستون های سفارشی مرتبط با یک مشتری.

فیلدها
custom_ columns[]

CustomColumn

ستون های سفارشی متعلق به مشتری ارائه شده است.

RawEventConversionDimensionHeader

پیام برای سرصفحه بعد تبدیل رویداد خام.

فیلدها
id

int64

شناسه متغیر سفارشی تبدیل.

name

string

نام بعدی رویداد خام توسط کاربر تعریف شده است.

RawEventConversionMetricHeader

پیام برای سرصفحه متریک تبدیل رویداد خام.

فیلدها
id

int64

شناسه متغیر سفارشی تبدیل.

name

string

نام متریک رویداد خام توسط کاربر تعریف شده است.

SearchAds360Row

یک ردیف برگشتی از پرس و جو.

فیلدها
ad_ group

AdGroup

گروه تبلیغاتی مورد اشاره در پرس و جو.

ad_ group_ ad

AdGroupAd

آگهی اشاره شده در پرس و جو.

ad_ group_ ad_ effective_ label

AdGroupAdEffectiveLabel

برچسب مؤثر آگهی گروه آگهی که در پرس و جو ارجاع شده است.

ad_ group_ ad_ label

AdGroupAdLabel

برچسب آگهی گروه تبلیغاتی که در پرس و جو ارجاع داده شده است.

ad_ group_ asset

AdGroupAsset

دارایی گروه تبلیغاتی که در پرس و جو به آن اشاره شده است.

ad_ group_ asset_ set

AdGroupAssetSet

مجموعه دارایی گروه تبلیغاتی که در جستار به آن اشاره شده است.

ad_ group_ audience_ view

AdGroupAudienceView

نمای مخاطب گروه تبلیغاتی که در پرس و جو به آن اشاره شده است.

ad_ group_ bid_ modifier

AdGroupBidModifier

اصلاح کننده قیمت پیشنهادی که در پرس و جو به آن اشاره شده است.

ad_ group_ criterion

AdGroupCriterion

معیاری که در پرس و جو به آن اشاره شده است.

ad_ group_ criterion_ effective_ label

AdGroupCriterionEffectiveLabel

برچسب موثر معیار گروه آگهی که در پرس و جو ارجاع شده است.

ad_ group_ criterion_ label

AdGroupCriterionLabel

برچسب معیار گروه آگهی که در پرس و جو ارجاع داده شده است.

ad_ group_ effective_ label

AdGroupEffectiveLabel

برچسب موثر گروه آگهی که در پرس و جو ارجاع داده شده است.

ad_ group_ label

AdGroupLabel

برچسب گروه تبلیغاتی که در پرس و جو ارجاع داده شده است.

age_ range_ view

AgeRangeView

نمای محدوده سنی اشاره شده در پرس و جو.

asset

Asset

دارایی مورد اشاره در پرس و جو.

asset_ group_ asset

AssetGroupAsset

دارایی گروه دارایی که در پرس و جو به آن اشاره شده است.

asset_ group_ signal

AssetGroupSignal

سیگنال گروه دارایی که در پرس و جو ارجاع داده شده است.

asset_ group_ listing_ group_ filter

AssetGroupListingGroupFilter

فیلتر گروه فهرست گروه دارایی که در جستار به آن ارجاع داده شده است.

asset_ group_ top_ combination_ view

AssetGroupTopCombinationView

نمای ترکیبی بالای گروه دارایی که در پرس و جو ارجاع داده شده است.

asset_ group

AssetGroup

گروه دارایی مورد اشاره در پرس و جو.

asset_ set_ asset

AssetSetAsset

دارایی مجموعه دارایی که در پرس و جو به آن اشاره شده است.

asset_ set

AssetSet

مجموعه دارایی مورد اشاره در پرس و جو.

bidding_ strategy

BiddingStrategy

استراتژی مناقصه اشاره شده در پرس و جو.

campaign_ budget

CampaignBudget

بودجه کمپین اشاره شده در پرس و جو.

campaign

Campaign

کمپین مورد اشاره در پرس و جو.

campaign_ asset

CampaignAsset

دارایی کمپین اشاره شده در پرس و جو.

campaign_ asset_ set

CampaignAssetSet

مجموعه دارایی کمپین مورد اشاره در پرس و جو.

campaign_ audience_ view

CampaignAudienceView

نمای مخاطب کمپین که در پرس و جو به آن اشاره شده است.

campaign_ criterion

CampaignCriterion

معیار کمپین مورد اشاره در پرس و جو.

campaign_ effective_ label

CampaignEffectiveLabel

برچسب موثر کمپین که در پرس و جو به آن اشاره شده است.

campaign_ label

CampaignLabel

برچسب کمپین مورد اشاره در پرس و جو.

cart_ data_ sales_ view

CartDataSalesView

نمای فروش داده های سبد خرید که در پرس و جو ارجاع شده است.

audience

Audience

مخاطبی که در پرس و جو به آن اشاره شده است.

conversion_ action

ConversionAction

عمل تبدیلی که در پرس و جو به آن اشاره شده است.

conversion_ custom_ variable

ConversionCustomVariable

متغیر سفارشی تبدیل که در پرس و جو ارجاع داده شده است.

customer

Customer

مشتری در پرس و جو به آن اشاره کرد.

customer_ asset

CustomerAsset

دارایی مشتری اشاره شده در پرس و جو.

customer_ asset_ set

CustomerAssetSet

مجموعه دارایی مشتری که در پرس و جو به آن اشاره شده است.

accessible_ bidding_ strategy

AccessibleBiddingStrategy

استراتژی مناقصه قابل دسترس که در پرس و جو به آن اشاره شده است.

customer_ client

CustomerClient

مشتری مشتری در پرس و جو به آن اشاره کرد.

dynamic_ search_ ads_ search_ term_ view

DynamicSearchAdsSearchTermView

مشاهده عبارت جستجوی تبلیغات جستجوی پویا که در پرس و جو ارجاع شده است.

gender_ view

GenderView

نمای جنسیتی اشاره شده در پرس و جو.

geo_ target_ constant

GeoTargetConstant

ثابت هدف جغرافیایی که در پرس و جو ارجاع داده شده است.

keyword_ view

KeywordView

نمای کلمه کلیدی مورد اشاره در پرس و جو.

label

Label

برچسب اشاره شده در پرس و جو.

language_ constant

LanguageConstant

ثابت زبان مورد اشاره در پرس و جو.

location_ view

LocationView

نمای مکان اشاره شده در پرس و جو.

product_ bidding_ category_ constant

ProductBiddingCategoryConstant

دسته مناقصه محصول اشاره شده در پرس و جو.

product_ group_ view

ProductGroupView

نمای گروه محصول اشاره شده در پرس و جو.

shopping_ performance_ view

ShoppingPerformanceView

نمای عملکرد خرید اشاره شده در پرس و جو.

user_ list

UserList

لیست کاربری که در پرس و جو به آن اشاره شده است.

user_ location_ view

UserLocationView

نمای موقعیت مکانی کاربر که در پرس و جو به آن اشاره شده است.

webpage_ view

WebpageView

نمای صفحه وب مورد اشاره در پرس و جو.

visit

Visit

بازدید سطح رویداد که در پرس و جو به آن اشاره شده است.

conversion

Conversion

تبدیل سطح رویداد که در پرس و جو ارجاع شده است.

metrics

Metrics

معیارها

segments

Segments

بخش ها

custom_ columns[]

Value

ستون های سفارشی

SearchSearchAds360FieldsRequest

درخواست پیام برای SearchAds360FieldService.SearchSearchAds360Fields .

فیلدها
query

string

مورد نیاز. رشته پرس و جو.

page_ token

string

نشانه صفحه برای بازیابی. اگر مشخص نشده باشد، صفحه اول نتایج برگردانده خواهد شد. از مقدار بدست آمده از next_page_token در پاسخ قبلی برای درخواست صفحه بعدی نتایج استفاده کنید.

page_ size

int32

تعداد عناصر برای بازیابی در یک صفحه هنگامی که یک صفحه خیلی بزرگ درخواست می شود، سرور ممکن است تصمیم بگیرد تعداد منابع برگشتی را بیشتر محدود کند.

SearchSearchAds360FieldsResponse

پیام پاسخ برای SearchAds360FieldService.SearchSearchAds360Fields .

فیلدها
results[]

SearchAds360Field

لیست فیلدهایی که با پرس و جو مطابقت دارند.

next_ page_ token

string

نشانه صفحه بندی برای بازیابی صفحه بعدی نتایج استفاده می شود. محتوای این رشته را به عنوان صفت page_token درخواست بعدی ارسال کنید. next_page_token برای صفحه آخر بازگردانده نمی شود.

total_ results_ count

int64

تعداد کل نتایجی که با پرس و جو مطابقت دارند و بند LIMIT را نادیده می گیرند.

SearchSearchAds360 Request

درخواست پیام برای SearchAds360Service.Search .

فیلدها
customer_ id

string

مورد نیاز. شناسه مشتری مورد سوال

query

string

مورد نیاز. رشته پرس و جو.

page_ token

string

نشانه صفحه برای بازیابی. اگر مشخص نشده باشد، صفحه اول نتایج برگردانده خواهد شد. از مقدار بدست آمده از next_page_token در پاسخ قبلی برای درخواست صفحه بعدی نتایج استفاده کنید.

page_ size

int32

تعداد عناصر برای بازیابی در یک صفحه هنگامی که یک صفحه خیلی بزرگ درخواست می شود، سرور ممکن است تصمیم بگیرد تعداد منابع برگشتی را بیشتر محدود کند.

validate_ only

bool

اگر درست باشد، درخواست تایید می شود اما اجرا نمی شود.

return_ total_ results_ count

bool

اگر درست باشد، تعداد کل نتایجی که با پرس و جو مطابقت دارند و بند LIMIT را نادیده می گیرند، در پاسخ لحاظ می شود. پیش فرض نادرست است.

summary_ row_ setting

SummaryRowSetting

تعیین می کند که آیا یک ردیف خلاصه بازگردانده می شود یا خیر. به طور پیش فرض، ردیف خلاصه برگردانده نمی شود. در صورت درخواست، ردیف خلاصه پس از بازگرداندن سایر نتایج پرس و جو، خود به خود در پاسخ ارسال می شود.

SearchSearchAds360 Response

پیام پاسخ برای SearchAds360Service.Search .

فیلدها
results[]

SearchAds360Row

لیست ردیف هایی که با پرس و جو مطابقت دارند.

next_ page_ token

string

نشانه صفحه بندی برای بازیابی صفحه بعدی نتایج استفاده می شود. محتوای این رشته را به عنوان صفت page_token درخواست بعدی ارسال کنید. next_page_token برای صفحه آخر بازگردانده نمی شود.

total_ results_ count

int64

تعداد کل نتایجی که با پرس و جو مطابقت دارند و بند LIMIT را نادیده می گیرند.

field_ mask

FieldMask

FieldMask که نشان می دهد چه فیلدهایی توسط کاربر درخواست شده است.

summary_ row

SearchAds360Row

ردیف خلاصه که شامل خلاصه معیارها در نتایج است. خلاصه معیارها به معنای تجمیع معیارها در همه نتایج است، در اینجا تجمیع می تواند مجموع، میانگین، نرخ و غیره باشد.

custom_ column_ headers[]

CustomColumnHeader

سرصفحه های ستون های سفارشی در نتایج.

conversion_ custom_ metric_ headers[]

ConversionCustomMetricHeader

سرصفحه‌های معیارهای سفارشی تبدیل در نتایج.

conversion_ custom_ dimension_ headers[]

ConversionCustomDimensionHeader

هدر ابعاد سفارشی تبدیل در نتایج.

raw_ event_ conversion_ metric_ headers[]

RawEventConversionMetricHeader

سرصفحه های معیارهای تبدیل رویداد خام در نتایج.

raw_ event_ conversion_ dimension_ headers[]

RawEventConversionDimensionHeader

هدر ابعاد تبدیل رویداد خام در نتایج.

SearchSearchAds360StreamRequest

درخواست پیام برای SearchAds360Service.SearchStream .

فیلدها
customer_ id

string

مورد نیاز. شناسه مشتری مورد سوال

query

string

مورد نیاز. رشته پرس و جو.

batch_ size

int32

تعداد ردیف‌هایی که در هر دسته پاسخ جریانی برگردانده می‌شوند. هنگامی که دسته خیلی بزرگ درخواست می شود، سرور ممکن است تصمیم بگیرد تعداد ردیف های برگشتی را بیشتر محدود کند.

summary_ row_ setting

SummaryRowSetting

تعیین می کند که آیا یک ردیف خلاصه بازگردانده می شود یا خیر. به طور پیش فرض، ردیف خلاصه برگردانده نمی شود. در صورت درخواست، ردیف خلاصه پس از بازگرداندن سایر نتایج پرس و جو، خود به خود در پاسخ ارسال می شود.

SearchSearchAds360StreamResponse

پیام پاسخ برای SearchAds360Service.SearchStream .

فیلدها
results[]

SearchAds360Row

لیست ردیف هایی که با پرس و جو مطابقت دارند.

field_ mask

FieldMask

FieldMask که نشان می دهد چه فیلدهایی توسط کاربر درخواست شده است.

summary_ row

SearchAds360Row

ردیف خلاصه که شامل خلاصه معیارها در نتایج است. خلاصه معیارها به معنای تجمیع معیارها در همه نتایج است، در اینجا تجمیع می تواند مجموع، میانگین، نرخ و غیره باشد.

custom_ column_ headers[]

CustomColumnHeader

سرصفحه های ستون های سفارشی در نتایج.

conversion_ custom_ metric_ headers[]

ConversionCustomMetricHeader

سرصفحه‌های معیارهای سفارشی تبدیل در نتایج.

conversion_ custom_ dimension_ headers[]

ConversionCustomDimensionHeader

سرصفحه بعد سفارشی تبدیل در نتایج.

raw_ event_ conversion_ metric_ headers[]

RawEventConversionMetricHeader

سرصفحه های معیارهای تبدیل رویداد خام در نتایج.

raw_ event_ conversion_ dimension_ headers[]

RawEventConversionDimensionHeader

هدر ابعاد تبدیل رویداد خام در نتایج.

request_ id

string

شناسه منحصر به فرد درخواست که برای اهداف اشکال زدایی استفاده می شود.