REST Resource: accounts.dataSources

ทรัพยากร: แหล่งข้อมูล

แหล่งข้อมูลสำหรับบัญชี Merchant Center

การแสดง JSON 
{
  "name": string,
  "dataSourceId": string,
  "displayName": string,
  "input": enum (Input),
  "fileInput": {
    object (FileInput)
  },

  // Union field Type can be only one of the following:
  "primaryProductDataSource": {
    object (PrimaryProductDataSource)
  },
  "supplementalProductDataSource": {
    object (SupplementalProductDataSource)
  },
  "localInventoryDataSource": {
    object (LocalInventoryDataSource)
  },
  "regionalInventoryDataSource": {
    object (RegionalInventoryDataSource)
  },
  "promotionDataSource": {
    object (PromotionDataSource)
  }
  // End of list of possible types for union field Type.
}
ช่อง
name

string

ตัวระบุ ชื่อของแหล่งข้อมูล รูปแบบ: {datasource.name=accounts/{account}/dataSources/{datasource}}
dataSourceId

string (int64 format)

เอาต์พุตเท่านั้น รหัสแหล่งข้อมูล
displayName

string

ต้องระบุ ชื่อแหล่งข้อมูลที่แสดงใน UI ของ Merchant Center
input

enum (Input)

เอาต์พุตเท่านั้น กำหนดประเภทของอินพุตสำหรับแหล่งข้อมูล การตั้งค่าบางอย่างอาจใช้งานไม่ได้ ทั้งนี้ขึ้นอยู่กับอินพุต คุณสร้างได้โดยใช้ API เฉพาะแหล่งข้อมูลทั่วไปเท่านั้น
fileInput

object (FileInput)

ไม่บังคับ ระบบจะใช้ช่องนี้เมื่อมีการจัดการข้อมูลผ่านไฟล์เท่านั้น
ช่องการรวม Type ประเภทแหล่งข้อมูล Type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
primaryProductDataSource

object (PrimaryProductDataSource)

ต้องระบุ แหล่งข้อมูลหลักสำหรับผลิตภัณฑ์ในพื้นที่และออนไลน์
supplementalProductDataSource

object (SupplementalProductDataSource)

ต้องระบุ แหล่งข้อมูลเสริมสำหรับผลิตภัณฑ์ในพื้นที่และออนไลน์
localInventoryDataSource

object (LocalInventoryDataSource)

ต้องระบุ แหล่งข้อมูลสินค้าคงคลังในร้าน
regionalInventoryDataSource

object (RegionalInventoryDataSource)

ต้องระบุ แหล่งข้อมูลสินค้าคงคลังระดับภูมิภาค
promotionDataSource

object (PromotionDataSource)

ต้องระบุ แหล่งข้อมูลโปรโมชัน

PrimaryProductDataSource

แหล่งข้อมูลหลักสำหรับผลิตภัณฑ์ในพื้นที่และออนไลน์

การแสดง JSON 
{
  "channel": enum (Channel),
  "countries": [
    string
  ],
  "feedLabel": string,
  "contentLanguage": string
}
ช่อง
channel

enum (Channel)

ต้องระบุ เปลี่ยนแปลงไม่ได้ ระบุประเภทของแชแนลของแหล่งข้อมูล
countries[]

string

ไม่บังคับ ประเทศที่อาจแสดงสินค้า แสดงเป็นรหัสเขตแดน CLDR
feedLabel

string

ไม่บังคับ เปลี่ยนแปลงไม่ได้ ป้ายกํากับฟีดที่ระบุในระดับแหล่งข้อมูล

ต้องน้อยกว่าหรือเท่ากับ 20 อักขระตัวพิมพ์ใหญ่ (A-Z) ตัวเลข (0-9) และขีดกลาง (-)

ดูข้อมูลเพิ่มเติมที่การย้ายข้อมูลไปยังป้ายกำกับฟีด

ต้องตั้งค่าหรือไม่ได้ตั้งค่า feedLabel และ contentLanguage สำหรับแหล่งข้อมูลที่มีประเภทเนื้อหาผลิตภัณฑ์ ซึ่งต้องตั้งค่าสำหรับแหล่งข้อมูลที่มีอินพุตไฟล์

หากตั้งค่าไว้ แหล่งข้อมูลจะยอมรับเฉพาะผลิตภัณฑ์ที่ตรงกับชุดค่าผสมนี้ หากไม่ได้ตั้งค่า แหล่งข้อมูลจะยอมรับผลิตภัณฑ์ที่ไม่มีข้อจำกัดดังกล่าว
contentLanguage

string

ไม่บังคับ เปลี่ยนแปลงไม่ได้ ภาษา ISO 639-1 แบบ 2 ตัวอักษรของรายการในแหล่งข้อมูล

ต้องตั้งค่าทั้ง feedLabel และ contentLanguage หรือไม่ตั้งค่า ยกเลิกการตั้งค่าช่องนี้ได้สำหรับแหล่งข้อมูลที่ไม่มีอินพุตไฟล์เท่านั้น

หากตั้งค่าไว้ แหล่งข้อมูลจะยอมรับเฉพาะผลิตภัณฑ์ที่ตรงกับชุดค่าผสมนี้ หากไม่ได้ตั้งค่า แหล่งข้อมูลจะยอมรับผลิตภัณฑ์ที่ไม่มีข้อจำกัดดังกล่าว

ช่อง

แชแนลแหล่งข้อมูล

แชแนลใช้เพื่อแยกแหล่งข้อมูลสำหรับประเภทธุรกิจที่แตกต่างกัน

Enum
CHANNEL_UNSPECIFIED ไม่ได้ระบุ
ONLINE_PRODUCTS ผลิตภัณฑ์ออนไลน์
LOCAL_PRODUCTS ผลิตภัณฑ์ในร้าน
PRODUCTS แหล่งข้อมูลแบบรวมสำหรับผลิตภัณฑ์ทั้งในท้องถิ่นและออนไลน์

SupplementalProductDataSource

แหล่งข้อมูลเสริมสำหรับผลิตภัณฑ์ในพื้นที่และออนไลน์

การแสดง JSON 
{
  "feedLabel": string,
  "contentLanguage": string
}
ช่อง
feedLabel

string

ไม่บังคับ เปลี่ยนแปลงไม่ได้ ป้ายกํากับฟีดที่ระบุในระดับแหล่งข้อมูล

ต้องน้อยกว่าหรือเท่ากับ 20 อักขระตัวพิมพ์ใหญ่ (A-Z) ตัวเลข (0-9) และขีดกลาง (-)

ดูข้อมูลเพิ่มเติมที่การย้ายข้อมูลไปยังป้ายกำกับฟีด

ต้องตั้งค่าหรือไม่ได้ตั้งค่า feedLabel และ contentLanguage สำหรับแหล่งข้อมูลที่มีประเภทเนื้อหาผลิตภัณฑ์ ซึ่งต้องตั้งค่าสำหรับแหล่งข้อมูลที่มีอินพุตไฟล์

หากตั้งค่าไว้ แหล่งข้อมูลจะยอมรับเฉพาะผลิตภัณฑ์ที่ตรงกับชุดค่าผสมนี้ หากไม่ได้ตั้งค่า แหล่งข้อมูลจะยอมรับผลิตภัณฑ์โดยไม่มีข้อจำกัดดังกล่าว
contentLanguage

string

ไม่บังคับ เปลี่ยนแปลงไม่ได้ ภาษา ISO 639-1 แบบ 2 ตัวอักษรของรายการในแหล่งข้อมูล

ต้องตั้งค่าทั้ง feedLabel และ contentLanguage หรือไม่ตั้งค่า ยกเลิกการตั้งค่าช่องนี้ได้สำหรับแหล่งข้อมูลที่ไม่มีอินพุตไฟล์เท่านั้น

หากตั้งค่าไว้ แหล่งข้อมูลจะยอมรับเฉพาะผลิตภัณฑ์ที่ตรงกับชุดค่าผสมนี้ หากไม่ได้ตั้งค่า แหล่งข้อมูลจะยอมรับผลิตภัณฑ์โดยไม่มีข้อจำกัดดังกล่าว

LocalInventoryDataSource

แหล่งข้อมูลสินค้าคงคลังในร้าน

การแสดง JSON 
{
  "feedLabel": string,
  "contentLanguage": string
}
ช่อง
feedLabel

string

ต้องระบุ เปลี่ยนแปลงไม่ได้ ป้ายกำกับฟีดของข้อเสนอที่แสดงสินค้าคงคลังในร้าน

ต้องน้อยกว่าหรือเท่ากับ 20 อักขระตัวพิมพ์ใหญ่ (A-Z) ตัวเลข (0-9) และขีดกลาง (-)

ดูข้อมูลเพิ่มเติมที่การย้ายข้อมูลไปยังป้ายกำกับฟีด
contentLanguage

string

ต้องระบุ เปลี่ยนแปลงไม่ได้ ภาษา ISO 639-1 แบบ 2 ตัวอักษรของสินค้าที่ระบุสินค้าคงคลังในร้าน

RegionalInventoryDataSource

แหล่งข้อมูลสินค้าคงคลังระดับภูมิภาค

การแสดง JSON 
{
  "feedLabel": string,
  "contentLanguage": string
}
ช่อง
feedLabel

string

ต้องระบุ เปลี่ยนแปลงไม่ได้ ป้ายกำกับฟีดของข้อเสนอที่ระบุสินค้าคงคลังระดับภูมิภาค

ต้องน้อยกว่าหรือเท่ากับ 20 อักขระตัวพิมพ์ใหญ่ (A-Z) ตัวเลข (0-9) และขีดกลาง (-)

ดูข้อมูลเพิ่มเติมที่การย้ายข้อมูลไปยังป้ายกำกับฟีด
contentLanguage

string

ต้องระบุ เปลี่ยนแปลงไม่ได้ ภาษา ISO 639-1 แบบ 2 ตัวอักษรของสินค้าที่ระบุสินค้าคงคลังระดับภูมิภาค

PromotionDataSource

แหล่งข้อมูลโปรโมชัน

การแสดง JSON 
{
  "targetCountry": string,
  "contentLanguage": string
}
ช่อง
targetCountry

string

ต้องระบุ เปลี่ยนแปลงไม่ได้ ประเทศเป้าหมายที่ใช้เป็นส่วนหนึ่งของตัวระบุที่ไม่ซ้ำกัน แสดงเป็นรหัสเขตแดน CLDR

โปรโมชันมีให้บริการเฉพาะในประเทศที่เลือกเท่านั้น
contentLanguage

string

ต้องระบุ เปลี่ยนแปลงไม่ได้ ภาษา ISO 639-1 แบบ 2 ตัวอักษรของรายการในแหล่งข้อมูล

อินพุต

กำหนดประเภทของอินพุตสำหรับแหล่งข้อมูล ระบบอาจไม่รองรับการตั้งค่าบางอย่าง ทั้งนี้ขึ้นอยู่กับอินพุต

Enum
INPUT_UNSPECIFIED ไม่ได้ระบุอินพุต
API แสดงแหล่งข้อมูลที่ระบุข้อมูลผ่าน API เป็นหลัก
FILE หมายถึงแหล่งข้อมูลที่มีการให้ข้อมูลผ่านอินพุตไฟล์เป็นหลัก ข้อมูลยังคงให้ผ่าน API ได้
UI

แหล่งข้อมูลสำหรับผลิตภัณฑ์ที่เพิ่มลงใน Merchant Center โดยตรง

และไม่สามารถสร้างหรืออัปเดตแหล่งข้อมูลประเภทนี้ผ่าน API นี้ แต่จะใช้ UI ของ Merchant Center ได้เท่านั้น

แหล่งข้อมูลประเภทนี้เป็นแบบอ่านอย่างเดียว
AUTOFEED วิธีนี้เรียกอีกอย่างว่าฟีดอัตโนมัติซึ่งใช้สร้างข้อมูลผลิตภัณฑ์โดยอัตโนมัติ คุณเปิดหรือปิดใช้แหล่งข้อมูลประเภทนี้ได้ผ่านกลุ่มบัญชี

FileInput

ข้อมูลเฉพาะสำหรับแหล่งข้อมูลไฟล์ ช่องนี้จะว่างเปล่าสําหรับอินพุตแหล่งข้อมูลอื่นๆ

การแสดง JSON 
{
  "fetchSettings": {
    object (FetchSettings)
  },
  "fileName": string,
  "fileInputType": enum (FileInputType)
}
ช่อง
fetchSettings

object (FetchSettings)

ไม่บังคับ เรียกรายละเอียดเพื่อส่งแหล่งข้อมูล ซึ่งมีการตั้งค่าสำหรับอินพุตไฟล์ FETCH และ GOOGLE_SHEETS ช่องที่ต้องกรอกจะแตกต่างกันไปตามความถี่ในการดึงข้อมูล
fileName

string

ไม่บังคับ ชื่อไฟล์ของแหล่งข้อมูล จำเป็นสำหรับอินพุตไฟล์ UPLOAD ประเภท
fileInputType

enum (FileInputType)

เอาต์พุตเท่านั้น ประเภทของอินพุตไฟล์

FetchSettings

เรียกรายละเอียดเพื่อส่งแหล่งข้อมูล

การแสดง JSON 
{
  "enabled": boolean,
  "dayOfMonth": integer,
  "timeOfDay": {
    object (TimeOfDay)
  },
  "dayOfWeek": enum (DayOfWeek),
  "timeZone": string,
  "frequency": enum (Frequency),
  "fetchUri": string,
  "username": string,
  "password": string
}
ช่อง
enabled

boolean

ไม่บังคับ เปิดใช้หรือหยุดกำหนดการเรียกข้อมูลชั่วคราว
dayOfMonth

integer

ไม่บังคับ วันของเดือนที่ควรดึงข้อมูลไฟล์แหล่งข้อมูล (1-31) ช่องนี้ตั้งค่าได้เฉพาะความถี่รายเดือนเท่านั้น
timeOfDay

object (TimeOfDay)

ไม่บังคับ ชั่วโมงของวันที่ควรดึงข้อมูลไฟล์แหล่งข้อมูล ระบบไม่รองรับนาทีและวินาทีและระบบจะไม่สนใจ
dayOfWeek

enum (DayOfWeek)

ไม่บังคับ วันของสัปดาห์ที่ควรดึงข้อมูลไฟล์แหล่งข้อมูล ตั้งค่าช่องนี้สำหรับความถี่รายสัปดาห์เท่านั้น
timeZone

string

ไม่บังคับ เขตเวลาที่ใช้สำหรับกำหนดการ UTC โดยค่าเริ่มต้น เช่น "America/Los_Angeles"
frequency

enum (Frequency)

ต้องระบุ ความถี่ที่อธิบายกำหนดการเรียกข้อมูล
fetchUri

string

ไม่บังคับ URL ที่สามารถดึงข้อมูลไฟล์แหล่งข้อมูลได้ Google Merchant Center รองรับการอัปโหลดที่ตั้งเวลาไว้อัตโนมัติโดยใช้โปรโตคอล HTTP, HTTPS หรือ SFTP ดังนั้นค่าจะต้องเป็นลิงก์ที่ถูกต้องโดยใช้โปรโตคอล 1 ใน 3 รายการข้างต้น เปลี่ยนแปลงไม่ได้สำหรับไฟล์ Google ชีต
username

string

ไม่บังคับ ชื่อผู้ใช้ที่ไม่บังคับสำหรับ [fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url] ใช้สำหรับการส่งแหล่งข้อมูลผ่าน SFTP
password

string

ไม่บังคับ รหัสผ่านที่ไม่บังคับสำหรับ [fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url] ใช้สำหรับการส่งแหล่งข้อมูลผ่าน SFTP

TimeOfDay

แสดงช่วงเวลาของวัน วันที่และเขตเวลาไม่มีความสำคัญหรือมีการระบุไว้ที่อื่น API อาจเลือกอนุญาตการใช้เวลาไม่กี่วินาที ประเภทที่เกี่ยวข้องคือ google.type.Date และ google.protobuf.Timestamp

การแสดง JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
ช่อง
hours

integer

ชั่วโมงของวันในรูปแบบ 24 ชั่วโมง ควรอยู่ระหว่าง 0 ถึง 23 API อาจเลือกอนุญาตค่า "24:00:00" สำหรับสถานการณ์ต่างๆ เช่น เวลาปิดทำการของธุรกิจ
minutes

integer

นาทีต่อชั่วโมง ต้องอยู่ระหว่าง 0 ถึง 59
seconds

integer

เวลาเป็นวินาที โดยปกติต้องอยู่ระหว่าง 0 ถึง 59 API อาจอนุญาตให้ใช้ค่า 60 หากอนุญาตให้มีวินาทีอธิกวาร
nanos

integer

เศษส่วนของวินาทีในหน่วยนาโนวินาที ต้องมีค่าตั้งแต่ 0 ถึง 999,999,999

DayOfWeek

แสดงวันของสัปดาห์

Enum
DAY_OF_WEEK_UNSPECIFIED ไม่ระบุวันของสัปดาห์
MONDAY วันจันทร์
TUESDAY วันอังคาร
WEDNESDAY วันพุธ
THURSDAY พฤหัสบดี
FRIDAY วันศุกร์
SATURDAY เสาร์
SUNDAY วันอาทิตย์

ความถี่

ช่องที่ต้องกรอกจะแตกต่างกันไปตามความถี่ในการดึงข้อมูล สำหรับกำหนดการเรียกข้อมูลรายเดือน ต้องระบุ [วันของเดือน][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] และ [hours of day][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] ต้องระบุเพียง [ชั่วโมงของวัน][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] สำหรับกำหนดการเรียกข้อมูลรายวัน

Enum
FREQUENCY_UNSPECIFIED ไม่ได้ระบุความถี่
FREQUENCY_DAILY การดึงข้อมูลจะเกิดขึ้นทุกวัน
FREQUENCY_WEEKLY การดึงข้อมูลจะเกิดขึ้นทุกสัปดาห์
FREQUENCY_MONTHLY การดึงข้อมูลจะเกิดขึ้นทุกเดือน

FileInputType

วิธีส่งไฟล์

Enum
FILE_INPUT_TYPE_UNSPECIFIED ไม่ได้ระบุประเภทอินพุตไฟล์
UPLOAD ระบบจะอัปโหลดไฟล์ผ่าน SFTP, Google Cloud Storage หรืออัปโหลดด้วยตนเองใน Merchant Center
FETCH ระบบจะดึงไฟล์จาก [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] ที่กำหนดค่า
GOOGLE_SHEETS ระบบจะดึงไฟล์จาก Google ชีตที่ระบุไว้ใน [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri]

วิธีการ

create

 สร้างการกำหนดค่าแหล่งข้อมูลใหม่สำหรับบัญชีที่กำหนด

delete

 ลบแหล่งข้อมูลออกจากบัญชี Merchant Center

fetch

 ดำเนินการดึงข้อมูลทันที (แม้นอกกำหนดการเรียกข้อมูล) ในแหล่งข้อมูลจากบัญชี Merchant Center

get

 เรียกข้อมูลการกำหนดค่าแหล่งข้อมูลสำหรับบัญชีที่ระบุ

list

 แสดงรายการการกำหนดค่าแหล่งข้อมูลสำหรับบัญชีที่ระบุ

patch

 อัปเดตการกำหนดค่าแหล่งข้อมูลที่มีอยู่