Method: customers.generateInsightsFinderReport

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

थ्रो की गई गड़बड़ियों की सूची: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

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

POST https://googleads.googleapis.com/v14/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)

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