- درخواست HTTP
- پارامترهای مسیر
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- BasicInsightsAudience
- AudienceInsightsTopic
- آن را امتحان کنید!
یک گزارش ذخیره شده ایجاد می کند که می تواند در ابزار Insights Finder مشاهده شود.
لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError FieldError HeaderError داخلی خطا QuotaError RangeError RequestError
درخواست HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}:generateInsightsFinderReport
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها | |
---|---|
customerId | مورد نیاز. شناسه مشتری. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "baselineAudience": { object ( |
فیلدها | |
---|---|
baselineAudience | مورد نیاز. مخاطبان اصلی این گزارش، معمولاً همه مردم یک منطقه. |
specificAudience | مورد نیاز. مخاطب خاص مورد علاقه این گزارش. بینشهای موجود در گزارش براساس ویژگیهایی است که در این مخاطبان شایعتر از مخاطبان اصلی گزارش هستند. |
customerInsightsGroup | نام مشتری که برای آن برنامه ریزی شده است. این یک مقدار تعریف شده توسط کاربر است. |
بدن پاسخگو
پیام پاسخ برای AudienceInsightsService.GenerateInsightsFinderReport
، حاوی URL قابل اشتراکگذاری برای گزارش.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "savedReportUrl": string } |
فیلدها | |
---|---|
savedReportUrl | یک نشانی وب HTTPS که یک پیوند عمیق به رابط کاربری Insights Finder ارائه میکند که ورودیهای گزارش مطابق درخواست پر شده است. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/adwords
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
BasicInsightsAudience
توصیفی از مخاطبی که برای درخواست اطلاعات استفاده می شود.
نمایندگی JSON |
---|
{ "countryLocation": [ { object ( |
فیلدها | |
---|---|
countryLocation[] | مورد نیاز. کشورهای برای این مخاطب. |
subCountryLocations[] | ویژگی های موقعیت جغرافیایی زیرکشور در صورت وجود، هر یک از اینها باید در یکی از کشورهای این مخاطبین موجود باشد. |
gender | جنسیت برای مخاطب در صورت عدم حضور، مخاطب بر اساس جنسیت محدودیت ایجاد نمی کند. |
ageRanges[] | محدوده سنی برای مخاطب در صورت عدم حضور، مخاطب نماینده همه افراد بالای 18 سال است که با سایر ویژگی ها مطابقت دارند. |
userInterests[] | علایق کاربر این مخاطب را تعریف می کند. مخاطبان Affinity و In-Market پشتیبانی می شوند. |
topics[] | موضوعاتی که توسط نهادهای نمودار دانش و/یا دستههای محصول و خدمات ارائه میشوند و این مخاطبان به آنها علاقه دارند. |
AudienceInsightsTopic
موجودیت یا دسته ای که نشان دهنده موضوعی است که مخاطب را تعریف می کند.
نمایندگی JSON |
---|
{ // Union field |
فیلدها | |
---|---|
topic حوزه اتحادیه . یک موجودیت یا ویژگی دسته. topic می تواند تنها یکی از موارد زیر باشد: | |
entity | یک موجودیت نمودار دانش |
category | دسته بندی محصولات و خدمات |