Package google.shopping.merchant.conversions.v1beta

इंडेक्स

ConversionSourcesService

यह सेवा, किसी व्यापारी खाते के लिए, कन्वर्ज़न के सोर्स को मैनेज करने की सेवा है.

CreateConversionSource

rpc CreateConversionSource(CreateConversionSourceRequest) returns (ConversionSource)

कन्वर्ज़न का नया सोर्स बनाता है.

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

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

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

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

rpc DeleteConversionSource(DeleteConversionSourceRequest) returns (Empty)

कन्वर्ज़न के किसी मौजूदा सोर्स को संग्रहित करता है. अगर कन्वर्ज़न का सोर्स, Merchant Center डेस्टिनेशन है, तो उसे 30 दिनों तक वापस पाया जा सकता है. अगर कन्वर्ज़न का सोर्स Google Analytics लिंक है, तो इसे तुरंत मिटा दिया जाएगा. साथ ही, नया लिंक बनाकर इसे वापस लाया जा सकता है.

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

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

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

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

rpc GetConversionSource(GetConversionSourceRequest) returns (ConversionSource)

कन्वर्ज़न का सोर्स फ़ेच करता है.

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

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

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

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

rpc ListConversionSources(ListConversionSourcesRequest) returns (ListConversionSourcesResponse)

कन्वर्ज़न के उन सोर्स की सूची वापस लाता है जिनका ऐक्सेस कॉलर के पास है.

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

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

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

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

rpc UndeleteConversionSource(UndeleteConversionSourceRequest) returns (ConversionSource)

कन्वर्ज़न के संग्रहित किए गए सोर्स को फिर से चालू करता है. यह सुविधा सिर्फ़ Merchant Center डेस्टिनेशन कन्वर्ज़न के सोर्स के लिए उपलब्ध है.

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

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

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

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

rpc UpdateConversionSource(UpdateConversionSourceRequest) returns (ConversionSource)

कन्वर्ज़न के मौजूदा सोर्स की जानकारी अपडेट करता है. यह सुविधा सिर्फ़ Merchant Center डेस्टिनेशन कन्वर्ज़न के सोर्स के लिए उपलब्ध है.

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

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

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

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

AttributionSettings

प्री-एट्रिब्यूशन डेटा पाने वाले कन्वर्ज़न सोर्स के लिए एट्रिब्यूशन सेटिंग दिखाता है.

फ़ील्ड
attribution_lookback_window_days

int32

ज़रूरी है. इस सोर्स में एट्रिब्यूशन के लिए, लुकबैक विंडो (दिनों में) का इस्तेमाल किया जाता है. वैल्यू के तौर पर 7, 30, 40 का इस्तेमाल किया जा सकता है.
attribution_model

AttributionModel

ज़रूरी है. एट्रिब्यूशन मॉडल.
conversion_type[]

ConversionType

इम्यूटेबल. बिना क्रम वाली सूची. कन्वर्ज़न इवेंट के अलग-अलग तरह के कन्वर्ज़न की सूची को कैटगरी में रखा जा सकता है. अगर सूची बनाते समय यह सूची खाली रहती है, तो एक स्टैंडर्ड "purchase" टाइप अपने-आप बन जाएगा.

AttributionModel

इस सोर्स के लिए इस्तेमाल किया गया एट्रिब्यूशन मॉडल. Google Analytics 4 से मिले मॉडल के ही सेट का इस्तेमाल किया जा सकता है. इनके बारे में यहां बताया गया है: https://support.google.com/analytics/answer/10596866.

Enums
ATTRIBUTION_MODEL_UNSPECIFIED मॉडल की जानकारी नहीं है.
CROSS_CHANNEL_LAST_CLICK क्रॉस-चैनल लास्ट क्लिक मॉडल.
ADS_PREFERRED_LAST_CLICK Google Ads की प्राथमिकता वाला लास्ट क्लिक मॉडल.
CROSS_CHANNEL_DATA_DRIVEN क्रॉस-चैनल डेटा-ड्रिवन मॉडल.
CROSS_CHANNEL_FIRST_CLICK क्रॉस-चैनल फ़र्स्ट क्लिक मॉडल.
CROSS_CHANNEL_LINEAR क्रॉस-चैनल लीनियर मॉडल.
CROSS_CHANNEL_POSITION_BASED क्रॉस-चैनल स्थिति आधारित मॉडल.
CROSS_CHANNEL_TIME_DECAY क्रॉस-चैनल टाइम डिके मॉडल.

ConversionType

कन्वर्ज़न इवेंट के टाइप दिखाने वाला मैसेज

फ़ील्ड
name

string

सिर्फ़ आउटपुट के लिए. कन्वर्ज़न इवेंट का नाम, क्योंकि इसकी रिपोर्ट क्लाइंट करेगा.
report

bool

सिर्फ़ आउटपुट के लिए. इस विकल्प से पता चलता है कि इस टाइप को Merchant Center की रिपोर्टिंग में शामिल किया जाना चाहिए या नहीं.

ConversionSource

कन्वर्ज़न का वह सोर्स दिखाता है जिसका मालिकाना हक, Merchant Center खाते के पास है. किसी व्यापारी खाते में कन्वर्ज़न के ज़्यादा से ज़्यादा 200 सोर्स हो सकते हैं.

फ़ील्ड
name

string

सिर्फ़ आउटपुट के लिए. आइडेंटिफ़ायर. नया ConversionSource बनाते समय, Content API से यह जनरेट होता है. फ़ॉर्मैट: [a-z]{4}:.+ कोलन से पहले के चार वर्ण, बातचीत के सोर्स के बारे में बताते हैं. कोलन के बाद का कॉन्टेंट, उस टाइप में कन्वर्ज़न के सोर्स का आईडी दिखाता है. कन्वर्ज़न के दो अलग-अलग सोर्स का आईडी, अलग-अलग टाइप के लिए एक जैसा हो सकता है. इस तरह के प्रीफ़िक्स इस्तेमाल किए जा सकते हैं: - galk: GoogleAnalyticsLink सोर्स के लिए. - mcdn: MerchantCenterDestination जाने वाले सोर्स के लिए.
state

State

सिर्फ़ आउटपुट के लिए. कन्वर्ज़न के इस सोर्स की मौजूदा स्थिति. एपीआई का इस्तेमाल करके, उसमें बदलाव नहीं किया जा सकता.
expire_time

Timestamp

सिर्फ़ आउटपुट के लिए. वह समय जब संग्रहित किया गया कन्वर्ज़न का सोर्स हमेशा के लिए मिट जाता है और मिटाए जाने का समय वापस नहीं लाया जा सकता.
controller

Controller

सिर्फ़ आउटपुट के लिए. कन्वर्ज़न के सोर्स का कंट्रोलर.
यूनियन फ़ील्ड source_data. ज़रूरी है. हर अलग तरह के सोर्स के लिए, कन्वर्ज़न के सोर्स का डेटा. source_data इनमें से सिर्फ़ एक हो सकती है:
merchant_center_destination

MerchantCenterDestination

"Merchant Center टैग डेस्टिनेशन" टाइप का कन्वर्ज़न सोर्स.

नियंत्रक

कन्वर्ज़न के सोर्स को कंट्रोल करने वाली इकाई.

Enums
CONTROLLER_UNSPECIFIED डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया गया है.
MERCHANT इसे वह कारोबारी कंट्रोल करता है जिसके पास कन्वर्ज़न सोर्स का मालिकाना हक है.
YOUTUBE_AFFILIATES इसे YT अफ़िलिएट प्रोग्राम कंट्रोल करता है.

स्थिति

कन्वर्ज़न के सोर्स की स्थिति दिखाता है.

Enums
STATE_UNSPECIFIED कन्वर्ज़न के सोर्स की स्थिति सेट नहीं की गई है.
ACTIVE कन्वर्ज़न का सोर्स पूरी तरह से काम कर रहा है.
ARCHIVED कन्वर्ज़न का सोर्स पिछले 30 दिनों में संग्रहित किया गया है और फ़िलहाल यह काम नहीं कर रहा है. मिटाए गए डेटा को वापस लाने के तरीके का इस्तेमाल करके, डेटा को वापस पाया जा सकता है.
PENDING कन्वर्ज़न का सोर्स बनाने की प्रक्रिया शुरू हो गई है, लेकिन अभी पूरी नहीं हुई है.

CreateConversionSourceRequest

CreateconversionSource तरीके के लिए अनुरोध वाला मैसेज.

फ़ील्ड
parent

string

ज़रूरी है. वह व्यापारी खाता जिसके पास कन्वर्ज़न के नए सोर्स का मालिकाना हक होगा. फ़ॉर्मैट: खाते/{account}
conversion_source

ConversionSource

ज़रूरी है. कन्वर्ज़न के सोर्स की जानकारी. आईडी बन जाने पर, उसे अपने-आप एक नया आईडी असाइन कर दिया जाएगा.

DeleteConversionSourceRequest

DeleteconversionSource तरीके के लिए अनुरोध वाला मैसेज.

फ़ील्ड
name

string

ज़रूरी है. मिटाए जाने वाले कन्वर्ज़न सोर्स का नाम. फ़ॉर्मैट: accounts/{account}/conversionSources/{conversion_source}

GetConversionSourceRequest

GetconversionSource तरीके के लिए अनुरोध वाला मैसेज.

फ़ील्ड
name

string

ज़रूरी है. फ़ेच किए जाने वाले कन्वर्ज़न के सोर्स का नाम. फ़ॉर्मैट: accounts/{account}/conversionsources/{conversion_source}

ListConversionSourcesRequest

ListconversionSources तरीके के लिए अनुरोध वाला मैसेज.

फ़ील्ड
parent

string

ज़रूरी है. वह व्यापारी खाता जिसके पास कन्वर्ज़न के सोर्स के कलेक्शन का मालिकाना हक है. फ़ॉर्मैट: खाते/{account}
page_size

int32

ज़रूरी नहीं. किसी पेज पर दिखाए जाने वाले कन्वर्ज़न के सोर्स की ज़्यादा से ज़्यादा संख्या. अगर page_size के बारे में नहीं बताया गया है, तो 100 को डिफ़ॉल्ट वैल्यू के तौर पर इस्तेमाल किया जाएगा. ज़्यादा से ज़्यादा वैल्यू 200 है. 200 से ज़्यादा वैल्यू को लागू करके 200 किया जाएगा. पेज में नंबर चाहे जो भी हो, कुल 200 कन्वर्ज़न सोर्स दिखाए जाते हैं.
page_token

string

ज़रूरी नहीं. पेज टोकन.
show_deleted

bool

ज़रूरी नहीं. मिटाए गए (संग्रहित किए गए) विकल्प दिखाएं.

ListConversionSourcesResponse

ListConvertSources तरीके के लिए रिस्पॉन्स मैसेज.

फ़ील्ड
conversion_sources[]

ConversionSource

कन्वर्ज़न के सोर्स की सूची.
next_page_token

string

अगले नतीजों के पेज को फ़ेच करने के लिए इस्तेमाल किया जाने वाला टोकन.

MerchantCenterDestination

"Merchant Center डेस्टिनेशन" सोर्स का इस्तेमाल, Google टैग का इस्तेमाल करके किसी ऑनलाइन स्टोर से कन्वर्ज़न इवेंट भेजने के लिए, सीधे उस Merchant Center खाते में किया जा सकता है जहां सोर्स बनाया गया हो.

फ़ील्ड
destination

string

सिर्फ़ आउटपुट के लिए. Merchant Center का डेस्टिनेशन आईडी.
attribution_settings

AttributionSettings

ज़रूरी है. Merchant Center डेस्टिनेशन के लिए इस्तेमाल की जा रही एट्रिब्यूशन सेटिंग का इस्तेमाल.
display_name

string

ज़रूरी है. डेस्टिनेशन के लिए व्यापारी का तय किया गया डिसप्ले नाम. इसी नाम से, Merchant Center के यूज़र इंटरफ़ेस (यूआई) में कन्वर्ज़न के सोर्स की पहचान होती है. इसमें 64 से ज़्यादा वर्ण इस्तेमाल नहीं किए जा सकते.
currency_code

string

ज़रूरी है. तीन अक्षर वाला मुद्रा कोड (ISO 4217). मुद्रा कोड से तय होता है कि इस डेस्टिनेशन पर भेजे गए कन्वर्ज़न, Merchant Center में किस मुद्रा में रिपोर्ट किए जाएंगे.

UndeleteConversionSourceRequest

UndeleteconversionSource तरीके के लिए अनुरोध वाला मैसेज.

फ़ील्ड
name

string

ज़रूरी है. कन्वर्ज़न के उस सोर्स का नाम जिसे मिटाया नहीं जाना है. फ़ॉर्मैट: accounts/{account}/conversionSources/{conversion_source}

UpdateConversionSourceRequest

अपडेटकन्वर्ज़नसोर्स तरीके के लिए अनुरोध का मैसेज.

फ़ील्ड
conversion_source

ConversionSource

ज़रूरी है. कन्वर्ज़न के सोर्स के डेटा का नया वर्शन. फ़ॉर्मैट: accounts/{account}/conversionSources/{conversion_source}
update_mask

FieldMask

ज़रूरी है. अपडेट किए जा रहे फ़ील्ड की सूची.