Method: customers.generateInsightsFinderReport

सेव की गई रिपोर्ट बनाता है, जिसे Insights Finder टूल में देखा जा सकता है.

इस्तेमाल की गई गड़बड़ियों की सूची: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

एचटीटीपी अनुरोध

POST https://googleads.googleapis.com/v16/customers/{customerId}:generateInsightsFinderReport

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ के पैरामीटर

पैरामीटर
customerId

string

ज़रूरी है. ग्राहक का आईडी.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:

जेएसओएन के काेड में दिखाना 
{
  "baselineAudience": {
    object (BasicInsightsAudience)
  },
  "specificAudience": {
    object (BasicInsightsAudience)
  },
  "customerInsightsGroup": string
}
फ़ील्ड
baselineAudience

object (BasicInsightsAudience)

ज़रूरी है. इस रिपोर्ट के लिए बेसलाइन ऑडियंस, आम तौर पर क्षेत्र के सभी लोग.
specificAudience

object (BasicInsightsAudience)

ज़रूरी है. इस रिपोर्ट में दिलचस्पी रखने वाली खास ऑडियंस. रिपोर्ट में दी गई अहम जानकारी, उन एट्रिब्यूट पर आधारित होगी जो रिपोर्ट की बेसलाइन ऑडियंस की तुलना में इस ऑडियंस में ज़्यादा मौजूद हैं.
customerInsightsGroup

string

जिस ग्राहक के लिए प्लान बनाया जा रहा है उसका नाम. यह उपयोगकर्ता की ओर से तय की गई वैल्यू है.

जवाब का मुख्य भाग

AudienceInsightsService.GenerateInsightsFinderReport के लिए जवाब का मैसेज, जिसमें रिपोर्ट का शेयर किया जा सकने वाला यूआरएल शामिल है.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जेएसओएन के काेड में दिखाना 
{
  "savedReportUrl": string
}
फ़ील्ड
savedReportUrl

string

एचटीटीपीएस यूआरएल, जिसमें Insights Finder के यूज़र इंटरफ़ेस (यूआई) का डीप लिंक होता है. इस लिंक में अनुरोध के हिसाब से रिपोर्ट इनपुट होते हैं.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

BasicInsightsAudience

अहम जानकारी का अनुरोध करने के लिए इस्तेमाल की जाने वाली ऑडियंस का ब्यौरा.

जेएसओएन के काेड में दिखाना 
{
  "countryLocation": [
    {
      object (LocationInfo)
    }
  ],
  "subCountryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "userInterests": [
    {
      object (UserInterestInfo)
    }
  ],
  "topics": [
    {
      object (AudienceInsightsTopic)
    }
  ]
}
फ़ील्ड
countryLocation[]

object (LocationInfo)

ज़रूरी है. इस ऑडियंस के लिए देश.
subCountryLocations[]

object (LocationInfo)

उप-देश भौगोलिक जगह के एट्रिब्यूट. अगर यह सुविधा मौजूद है, तो ये सभी विकल्प, ऑडियंस में शामिल किसी एक देश में शामिल होने चाहिए.
gender

object (GenderInfo)

दर्शकों के लिए लिंग. अगर यह वीडियो नहीं है, तो दर्शकों पर लिंग के आधार पर कोई पाबंदी नहीं लगाई जाती.
ageRanges[]

object (AgeRangeInfo)

ऑडियंस के लिए उम्र की सीमा. अगर यह नहीं है, तो ऑडियंस में 18 साल से ज़्यादा उम्र के उन सभी लोगों को शामिल किया जाता है जो अन्य एट्रिब्यूट से मेल खाते हैं.
userInterests[]

object (UserInterestInfo)

इस ऑडियंस को तय करने वाली उपयोगकर्ता की दिलचस्पियां. अफ़िनिटी ऑडियंस और एक जैसे प्रॉडक्ट या सेवा में दिलचस्पी रखने वाले ग्राहक काम करते हैं.
topics[]

object (AudienceInsightsTopic)

ऐसे विषय जिनमें इस ऑडियंस की दिलचस्पी है. ऐसे विषय, नॉलेज ग्राफ़ इकाइयों और/या प्रॉडक्ट और सेवा की कैटगरी के ज़रिए दिखाए जाते हैं.

AudienceInsightsTopic

ऑडियंस तय करने वाले विषय को दिखाने वाली इकाई या कैटगरी.

जेएसओएन के काेड में दिखाना 
{

  // Union field topic can be only one of the following:
  "entity": {
    object (AudienceInsightsEntity)
  },
  "category": {
    object (AudienceInsightsCategory)
  }
  // End of list of possible types for union field topic.
}
फ़ील्ड
यूनियन फ़ील्ड topic. कोई इकाई या कैटगरी एट्रिब्यूट. topic इनमें से सिर्फ़ एक हो सकती है:
entity

object (AudienceInsightsEntity)

नॉलेज ग्राफ़ वाली इकाई
category

object (AudienceInsightsCategory)

प्रॉडक्ट और सेवा की कैटगरी