Package google.shopping.merchant.datasources.v1beta

इंडेक्स

DataSourcesService

प्राइमरी, पूरक, इन्वेंट्री, और अन्य डेटा सोर्स को मैनेज करने की सेवा. ज़्यादा जानकारी के लिए, Merchant Center का सहायता लेख पढ़ें.

CreateDataSource

rpc CreateDataSource(CreateDataSourceRequest) returns (DataSource)

दिए गए खाते के लिए, नया डेटा सोर्स कॉन्फ़िगरेशन बनाता है.

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

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

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

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

rpc DeleteDataSource(DeleteDataSourceRequest) returns (Empty)

आपके Merchant Center खाते से डेटा सोर्स मिटा देता है.

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

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

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

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

rpc FetchDataSource(FetchDataSourceRequest) returns (Empty)

यह आपके Merchant Center खाते से किसी डेटा सोर्स पर, डेटा को तुरंत फ़ेच करता है (फ़ीड पाने के शेड्यूल से बाहर भी). अगर आपको एक दिन में इस तरीके को एक से ज़्यादा बार कॉल करने की ज़रूरत पड़ती है, तो आपको इसके बजाय अपने प्रॉडक्ट डेटा को अपडेट करने के लिए प्रॉडक्ट सेवा का इस्तेमाल करना चाहिए. यह तरीका, सिर्फ़ उन डेटा सोर्स पर काम करता है जिनमें फ़ाइल इनपुट सेट हो.

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

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

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

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

rpc GetDataSource(GetDataSourceRequest) returns (DataSource)

दिए गए खाते के डेटा सोर्स कॉन्फ़िगरेशन को हासिल करता है.

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

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

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

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

rpc ListDataSources(ListDataSourcesRequest) returns (ListDataSourcesResponse)

दिए गए खाते के डेटा सोर्स के कॉन्फ़िगरेशन की सूची बनाता है.

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

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

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

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

rpc UpdateDataSource(UpdateDataSourceRequest) returns (DataSource)

मौजूदा डेटा सोर्स कॉन्फ़िगरेशन को अपडेट करता है. अपडेट मास्क में सेट किए गए, लेकिन संसाधन में नहीं दिए गए फ़ील्ड मिटा दिए जाएंगे.

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

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

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

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

CreateDataSourceRequest

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

फ़ील्ड
parent

string

ज़रूरी है. वह खाता जिसमें डेटा सोर्स बनाया जाएगा. फ़ॉर्मैट: accounts/{account}
data_source

DataSource

ज़रूरी है. बनाया जाने वाला डेटा सोर्स.

DataSource

Merchant Center खाते का डेटा सोर्स.

फ़ील्ड
name

string

आइडेंटिफ़ायर. डेटा सोर्स का नाम. फ़ॉर्मैट: {datasource.name=accounts/{account}/dataSources/{datasource}}
data_source_id

int64

सिर्फ़ आउटपुट के लिए. डेटा सोर्स का आईडी.
display_name

string

ज़रूरी है. Merchant Center के यूज़र इंटरफ़ेस (यूआई) में दिखाया गया डेटा सोर्स का नाम.
input

Input

सिर्फ़ आउटपुट के लिए. इससे डेटा सोर्स में इनपुट टाइप तय किया जाता है. इनपुट के आधार पर, हो सकता है कि कुछ सेटिंग काम न करें. एपीआई की मदद से सिर्फ़ सामान्य डेटा सोर्स बनाए जा सकते हैं.
file_input

FileInput

ज़रूरी नहीं. इस फ़ील्ड का इस्तेमाल सिर्फ़ तब किया जाता है, जब डेटा को किसी फ़ाइल के ज़रिए मैनेज किया जाता है.
यूनियन फ़ील्ड Type. डेटा सोर्स का टाइप. Type इनमें से सिर्फ़ एक हो सकता है:
primary_product_data_source

PrimaryProductDataSource

ज़रूरी है. स्थानीय और ऑनलाइन प्रॉडक्ट के लिए प्राइमरी डेटा सोर्स.
supplemental_product_data_source

SupplementalProductDataSource

ज़रूरी है. स्थानीय और ऑनलाइन प्रॉडक्ट के लिए पूरक डेटा सोर्स.
local_inventory_data_source

LocalInventoryDataSource

ज़रूरी है. स्थानीय इन्वेंट्री का डेटा सोर्स.
regional_inventory_data_source

RegionalInventoryDataSource

ज़रूरी है. रीजनल इन्वेंट्री का डेटा सोर्स.
promotion_data_source

PromotionDataSource

ज़रूरी है. प्रमोशन का डेटा सोर्स.

इनपुट

इससे डेटा सोर्स में इनपुट टाइप तय किया जाता है. इनपुट के आधार पर, हो सकता है कि कुछ सेटिंग काम न करें.

Enums
INPUT_UNSPECIFIED इनपुट की जानकारी नहीं दी गई है.
API इससे उन डेटा सोर्स की जानकारी मिलती है जिनके लिए, एपीआई की मदद से मुख्य तौर पर डेटा दिया जाता है.
FILE इससे उन डेटा सोर्स को दिखाया जाता है जिनके लिए, फ़ाइल इनपुट के ज़रिए डेटा दिया जाता है. एपीआई की मदद से डेटा अब भी उपलब्ध कराया जा सकता है.
UI

सीधे तौर पर Merchant Center में जोड़े गए प्रॉडक्ट का डेटा सोर्स.

इस एपीआई से, सिर्फ़ Merchant Center के यूज़र इंटरफ़ेस (यूआई) से इस तरह का डेटा सोर्स बनाया या अपडेट नहीं किया जा सकता.

इस तरह का डेटा सोर्स रीड ओनली होता है.
AUTOFEED इसे ऑटोमेटेड फ़ीड के नाम से भी जाना जाता है. इसका इस्तेमाल, आपका प्रॉडक्ट डेटा अपने-आप बनाने के लिए किया जाता है. इस तरह के डेटा सोर्स को खाता बंडल की मदद से चालू या बंद किया जा सकता है.

DeleteDataSourceRequest

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

फ़ील्ड
name

string

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

FetchDataSourceRequest

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

फ़ील्ड
name

string

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

FileInput

फ़ाइल डेटा सोर्स के लिए खास डेटा. यह फ़ील्ड, अन्य डेटा सोर्स के इनपुट के लिए खाली है.

फ़ील्ड
fetch_settings

FetchSettings

ज़रूरी नहीं. डेटा सोर्स डिलीवर करने के लिए जानकारी फ़ेच करें. इसमें FETCH और GOOGLE_SHEETS फ़ाइल इनपुट टाइप के लिए सेटिंग मौजूद हैं. ज़रूरी फ़ील्ड, फ़ेच करने की फ़्रीक्वेंसी के आधार पर अलग-अलग होते हैं.
file_name

string

ज़रूरी नहीं. डेटा सोर्स की फ़ाइल का नाम. UPLOAD फ़ाइल इनपुट टाइप के लिए ज़रूरी है.
file_input_type

FileInputType

सिर्फ़ आउटपुट के लिए. फ़ाइल इनपुट का टाइप.

FetchSettings

डेटा सोर्स डिलीवर करने के लिए जानकारी फ़ेच करें.

फ़ील्ड
enabled

bool

ज़रूरी नहीं. फ़ेच करने के शेड्यूल को चालू करता है या रोकता है.
day_of_month

int32

ज़रूरी नहीं. महीने का वह दिन जब डेटा सोर्स फ़ाइल को फ़ेच किया जाना चाहिए (1-31). इस फ़ील्ड को सिर्फ़ महीने की फ़्रीक्वेंसी के लिए सेट किया जा सकता है.
time_of_day

TimeOfDay

ज़रूरी नहीं. दिन का वह समय जब डेटा सोर्स फ़ाइल को फ़ेच किया जाना चाहिए. मिनट और सेकंड समर्थित नहीं हैं और उन्हें अनदेखा कर दिया जाएगा.
day_of_week

DayOfWeek

ज़रूरी नहीं. हफ़्ते का वह दिन जब डेटा सोर्स फ़ाइल को फ़ेच किया जाना चाहिए. इस फ़ील्ड को सिर्फ़ हफ़्ते की फ़्रीक्वेंसी के लिए सेट किया जा सकता है.
time_zone

string

ज़रूरी नहीं. शेड्यूल के लिए इस्तेमाल किया जाने वाला टाइम ज़ोन. डिफ़ॉल्ट रूप से यूटीसी. उदाहरण के लिए, "America/Los_Angeles".
frequency

Frequency

ज़रूरी है. फ़ेच करने के शेड्यूल के बारे में बताने वाली फ़्रीक्वेंसी.
fetch_uri

string

ज़रूरी नहीं. वह यूआरएल जहां डेटा सोर्स की फ़ाइल फ़ेच की जा सकती है. Google Merchant Center में, एचटीटीपी, एचटीटीपीएस या एसएफ़टीपी प्रोटोकॉल का इस्तेमाल करके, अपने-आप शेड्यूल किए गए अपलोड काम करते हैं. इसलिए, वैल्यू उन तीन प्रोटोकॉल में से किसी एक का इस्तेमाल करके, एक मान्य लिंक होनी चाहिए. Google Sheets फ़ाइलों के लिए नहीं बदला जा सकता.
username

string

ज़रूरी नहीं. [फ़ेच यूआरएल][google.shopping.content.bundles.DataSources.File Input.fetch_url] के लिए एक वैकल्पिक उपयोगकर्ता नाम. इसका इस्तेमाल एसएफ़टीपी के ज़रिए डेटा सोर्स सबमिट करने के लिए किया जाता है.
password

string

ज़रूरी नहीं. [फ़ेच यूआरएल][google.shopping.content.bundles.DataSources.Fileinput.fetch_url] के लिए एक वैकल्पिक पासवर्ड. इसका इस्तेमाल एसएफ़टीपी के ज़रिए डेटा सोर्स सबमिट करने के लिए किया जाता है.

फ़्रीक्वेंसी

ज़रूरी फ़ील्ड, फ़ेच करने की फ़्रीक्वेंसी के आधार पर अलग-अलग होते हैं. महीने के हिसाब से फ़ेच करने के शेड्यूल के लिए, [महीने का दिन][google.shopping.content.bundles.DataSources.Fileinput.FetchSchedule.day_of_month] और [दिन का घंटा][google.shopping.content.bundles.DataSources.Fileinput.FetchSchedule.time_of_day] ज़रूरी हैं. हर हफ़्ते फ़ेच करने के शेड्यूल के लिए, [हफ़्ते का दिन][google.shopping.content.bundles.DataSources.Fileinput.FetchSchedule.day_of_week] और [दिन का घंटा][google.shopping.content.bundles.DataSources.File Input.FetchSchedule.time_of_day] ज़रूरी हैं. फ़ीड पाने के हर दिन के शेड्यूल के लिए, सिर्फ़ [दिन का एक घंटा][google.shopping.content.bundles.DataSources.Fileinput.FetchSchedule.time_of_day] ज़रूरी होते हैं.

Enums
FREQUENCY_UNSPECIFIED फ़्रीक्वेंसी नहीं दी गई है.
FREQUENCY_DAILY फ़ेच रोज़ होता है.
FREQUENCY_WEEKLY फ़ेच हर हफ़्ते होता है.
FREQUENCY_MONTHLY फ़ेच करने की प्रोसेस हर महीने होती है.

FileInputType

फ़ाइल डिलीवरी का तरीका.

Enums
FILE_INPUT_TYPE_UNSPECIFIED फ़ाइल इनपुट टाइप की जानकारी नहीं दी गई है.
UPLOAD फ़ाइल को एसएफ़टीपी, Google Cloud Storage या Merchant Center में मैन्युअल तरीके से अपलोड किया जाता है.
FETCH फ़ाइल को कॉन्फ़िगर किए गए [फ़ेच_uri][google.shopping.content.bundles.DataSources.File Input.FetchSettings.fetch_uri] से फ़ेच किया जाता है.
GOOGLE_SHEETS फ़ाइल को [फ़ेच_uri][google.shopping.content.bundles.DataSources.File Input.FetchSettings.fetch_uri] में बताए गए Google Sheets से फ़ेच किया जाता है.

GetDataSourceRequest

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

फ़ील्ड
name

string

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

ListDataSourcesRequest

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

फ़ील्ड
parent

string

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

int32

ज़रूरी नहीं. दिए जाने वाले डेटा सोर्स की ज़्यादा से ज़्यादा संख्या. सेवा इस वैल्यू से कम वैल्यू दिखा सकती है. सबसे ज़्यादा वैल्यू 1,000 है. वहीं, 1,000 से ज़्यादा वैल्यू को 1,000 बना दिया जाएगा. अगर जानकारी नहीं दी गई है, तो ज़्यादा से ज़्यादा डेटा सोर्स दिखाए जाएंगे.
page_token

string

ज़रूरी नहीं. पिछले ListDataSources कॉल से मिला पेज टोकन. अगले पेज को वापस पाने के लिए, यह जानकारी दें.

पेजों पर नंबर डालते समय, ListDataSources को दिए गए अन्य सभी पैरामीटर, पेज टोकन देने वाले कॉल से मैच होने चाहिए.

ListDataSourcesResponse

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

फ़ील्ड
data_sources[]

DataSource

बताए गए खाते के डेटा सोर्स.
next_page_token

string

एक टोकन, जिसे अगला पेज फिर से पाने के लिए page_token के तौर पर भेजा जा सकता है. अगर इस फ़ील्ड को हटा दिया जाता है, तो इसके बाद कोई पेज नहीं होता.

LocalInventoryDataSource

स्थानीय इन्वेंट्री का डेटा सोर्स.

फ़ील्ड
feed_label

string

ज़रूरी है. इम्यूटेबल. उन ऑफ़र का फ़ीड लेबल जिनके लिए स्थानीय इन्वेंट्री दी गई है.

यह 20 अपरकेस अक्षरों (A-Z), संख्याओं (0-9), और डैश (-) से कम या उसके बराबर होना चाहिए.

फ़ीड के लेबल पर माइग्रेट करना भी देखें.
content_language

string

ज़रूरी है. इम्यूटेबल. उन आइटम की दो अक्षर वाली ISO 639-1 भाषा, जिन्हें स्थानीय इन्वेंट्री दी गई है.

PrimaryProductDataSource

स्थानीय और ऑनलाइन प्रॉडक्ट के लिए प्राइमरी डेटा सोर्स.

फ़ील्ड
channel

Channel

ज़रूरी है. इम्यूटेबल. इससे पता चलता है कि डेटा सोर्स चैनल किस तरह का है.
countries[]

string

ज़रूरी नहीं. वे देश जहां आइटम दिखाए जा सकते हैं. इसे देश/इलाके के CLDR कोड के तौर पर दिखाया जाता है.
feed_label

string

ज़रूरी नहीं. इम्यूटेबल. डेटा सोर्स के लेवल पर तय किया गया फ़ीड का लेबल.

यह 20 अपरकेस अक्षरों (A-Z), संख्याओं (0-9), और डैश (-) से कम या उसके बराबर होना चाहिए.

फ़ीड के लेबल पर माइग्रेट करना भी देखें.

प्रॉडक्ट कॉन्टेंट वाले डेटा सोर्स के लिए, feedLabel और contentLanguage, दोनों को सेट किया जाना चाहिए या सेट नहीं किया जाना चाहिए. इन्हें फ़ाइल इनपुट वाले डेटा सोर्स के लिए सेट किया जाना चाहिए.

अगर यह नीति सेट की जाती है, तो डेटा सोर्स सिर्फ़ इस कॉम्बिनेशन से मेल खाने वाले प्रॉडक्ट स्वीकार करेगा. अगर यह नीति सेट नहीं है, तो डेटा सोर्स उन प्रॉडक्ट को स्वीकार करेगा जिनके लिए यह पाबंदी नहीं लगाई गई है.
content_language

string

ज़रूरी नहीं. इम्यूटेबल. डेटा सोर्स में मौजूद आइटम की दो अक्षर वाली ISO 639-1 भाषा.

feedLabel और contentLanguage, दोनों को सेट किया जाना चाहिए या सेट नहीं किया जाना चाहिए. फ़ील्ड सिर्फ़ उन डेटा सोर्स के लिए सेट नहीं किए जा सकते जिनमें फ़ाइल इनपुट नहीं है.

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

चैनल

डेटा सोर्स चैनल.

चैनल का इस्तेमाल, अलग-अलग प्रॉडक्ट वर्टिकल के डेटा सोर्स में अंतर करने के लिए किया जाता है.

Enums
CHANNEL_UNSPECIFIED तय नहीं किया गया.
ONLINE_PRODUCTS ऑनलाइन प्रॉडक्ट.
LOCAL_PRODUCTS स्थानीय प्रॉडक्ट.
PRODUCTS स्थानीय और ऑनलाइन प्रॉडक्ट, दोनों के लिए यूनिफ़ाइड डेटा सोर्स.

PromotionDataSource

प्रमोशन का डेटा सोर्स.

फ़ील्ड
target_country

string

ज़रूरी है. इम्यूटेबल. टारगेट किया गया देश, जिसका इस्तेमाल यूनीक आइडेंटिफ़ायर के तौर पर किया जाता है. इसे देश/इलाके के CLDR कोड के तौर पर दिखाया जाता है.

प्रमोशन सिर्फ़ चुनिंदा देशों में उपलब्ध हैं.
content_language

string

ज़रूरी है. इम्यूटेबल. डेटा सोर्स में मौजूद आइटम की दो अक्षर वाली ISO 639-1 भाषा.

RegionalInventoryDataSource

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

फ़ील्ड
feed_label

string

ज़रूरी है. इम्यूटेबल. उन ऑफ़र का फ़ीड लेबल जिनके लिए रीजनल इन्वेंट्री दी गई है.

यह 20 अपरकेस अक्षरों (A-Z), संख्याओं (0-9), और डैश (-) से कम या उसके बराबर होना चाहिए.

फ़ीड के लेबल पर माइग्रेट करना भी देखें.
content_language

string

ज़रूरी है. इम्यूटेबल. उन आइटम की दो अक्षर वाली ISO 639-1 भाषा, जिन्हें रीजनल इन्वेंट्री दी गई है.

SupplementalProductDataSource

स्थानीय और ऑनलाइन प्रॉडक्ट के लिए पूरक डेटा सोर्स.

फ़ील्ड
feed_label

string

ज़रूरी नहीं. इम्यूटेबल. डेटा सोर्स के लेवल पर तय किया गया फ़ीड का लेबल.

यह 20 अपरकेस अक्षरों (A-Z), संख्याओं (0-9), और डैश (-) से कम या उसके बराबर होना चाहिए.

फ़ीड के लेबल पर माइग्रेट करना भी देखें.

प्रॉडक्ट कॉन्टेंट वाले डेटा सोर्स के लिए, feedLabel और contentLanguage, दोनों को सेट किया जाना चाहिए या सेट नहीं किया जाना चाहिए. इन्हें फ़ाइल इनपुट वाले डेटा सोर्स के लिए सेट किया जाना चाहिए.

अगर यह नीति सेट की जाती है, तो डेटा सोर्स सिर्फ़ इस कॉम्बिनेशन से मेल खाने वाले प्रॉडक्ट स्वीकार करेगा. अगर नीति को सेट नहीं किया जाता है, तो डेटा सोर्स, इस पाबंदी के बिना प्रोडक्शन स्वीकार करेगा.
content_language

string

ज़रूरी नहीं. इम्यूटेबल. डेटा सोर्स में मौजूद आइटम की दो अक्षर वाली ISO 639-1 भाषा.

feedLabel और contentLanguage, दोनों को सेट किया जाना चाहिए या सेट नहीं किया जाना चाहिए. फ़ील्ड सिर्फ़ उन डेटा सोर्स के लिए सेट नहीं किए जा सकते जिनमें फ़ाइल इनपुट नहीं है.

अगर यह नीति सेट की जाती है, तो डेटा सोर्स सिर्फ़ इस कॉम्बिनेशन से मेल खाने वाले प्रॉडक्ट स्वीकार करेगा. अगर नीति को सेट नहीं किया जाता है, तो डेटा सोर्स, इस पाबंदी के बिना प्रोडक्शन स्वीकार करेगा.

UpdateDataSourceRequest

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

फ़ील्ड
data_source

DataSource

ज़रूरी है. अपडेट किया जाने वाला डेटा सोर्स संसाधन.
update_mask

FieldMask

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

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

पूरे डेटा सोर्स को बदलने के लिए, खास "*" वैल्यू का इस्तेमाल नहीं किया जा सकता.