Настройки возврата товарных объявлений и бесплатных предложений

Если вы размещаете товары через товарные объявления или бесплатные объявления, вы можете использовать returnpolicyonline для создания, просмотра, редактирования или удаления правил онлайн-возврата со следующими атрибутами:

Для продуктов, продаваемых через товарные объявления или бесплатные объявления, обратный адрес не требуется.

Дополнительную информацию см . в разделе Настройка правил возврата для товарных объявлений и бесплатных предложений .

список

Вы можете использовать returnpolicyonline.list чтобы перечислить все существующие онлайн-политики возврата. Чтобы просмотреть конкретную политику возврата по идентификатору, см. get .

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/returnpolicyonline

Вот пример ответа:

{
 
"returnPolicies": [
   
{
     
"returnPolicyId": "transactions:US:default",
     
"label": "default",
     
"countries": [
       
"GB"
     
],
     
"policy": {
       
"type": "NUMBER_OF_DAYS_AFTER_DELIVERY",
       
"days": "90"
     
},
     
"restockingFee": {
       
"fixedFee": {
         
"value": "5.99",
         
"currency": "GBP"
       
}
     
},
     
"returnMethods": [
       
"IN_STORE",
       
"BY_MAIL"
     
],
     
"itemConditions": [
       
"NEW",
       
"USED"
     
],
     
"returnReasonCategoryInfo": [
       
{
         
"returnReasonCategory": "ITEM_DEFECT",
         
"returnLabelSource": "DOWNLOAD_AND_PRINT",
         
"returnShippingFee": {
           
"type": "FIXED",
           
"fixedFee": {
             
"value": "0.00",
             
"currency": "GBP"
           
}
         
}
       
},
       
{
         
"returnReasonCategory": "BUYER_REMORSE",
         
"returnLabelSource": "DOWNLOAD_AND_PRINT",
         
"returnShippingFee": {
           
"type": "FIXED",
           
"fixedFee": {
             
"value": "0.00",
             
"currency": "GBP"
           
}
         
}
       
}
     
],
     
"returnPolicyUri": "https://www.example.com/return-policy"
   
},
   
{
     
"returnPolicyId": "transactions:US:default",
     
"label": "default120days",
     
"countries": [
       
"US",
       
"FR"
     
],
     
"name": "returnpolicy120days",
     
"policy": {
       
"type": "NUMBER_OF_DAYS_AFTER_DELIVERY",
       
"days": "90"
     
},
     
"restockingFee": {
       
"fixedFee": {
         
"value": "0.00",
         
"currency": "USD"
       
}
     
},
     
"returnMethods": [
       
"BY_MAIL"
     
],
     
"itemConditions": [
       
"NEW",
       
"USED"
     
],
     
"returnReasonCategoryInfo": [
       
{
         
"returnReasonCategory": "ITEM_DEFECT",
         
"returnLabelSource": "DOWNLOAD_AND_PRINT",
         
"returnShippingFee": {
           
"type": "FIXED",
           
"fixedFee": {
             
"value": "0.00",
             
"currency": "USD"
           
}
         
}
       
},
       
{
         
"returnReasonCategory": "BUYER_REMORSE",
         
"returnLabelSource": "DOWNLOAD_AND_PRINT",
         
"returnShippingFee": {
           
"type": "FIXED",
           
"fixedFee": {
             
"value": "0.00",
             
"currency": "USD"
           
}
         
}
       
}
     
],
     
"returnPolicyUri": "https://www.example.com/return-policy"
   
}
 
]
}

получать

Вы можете использовать returnpolicyonline.get чтобы получить конкретную политику возврата с помощью returnPolicyId . Этот метод возвращает единую политику возврата. Чтобы просмотреть все правила возврата одновременно, см. list .

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/returnpolicyonline/returnPolicyId

Вот пример ответа:

{
 
"returnPolicyId": "transactions:US:default",
 
"label": "default",
 
"countries": [
   
"US"
 
],
 
"policy": {
   
"type": "NUMBER_OF_DAYS_AFTER_DELIVERY",
   
"days": "90"
 
},
 
"restockingFee": {
   
"fixedFee": {
     
"value": "0.00",
     
"currency": "USD"
   
}
 
},
 
"returnMethods": [
   
"BY_MAIL"
 
],
 
"itemConditions": [
   
"NEW",
   
"USED"
 
],
 
"returnReasonCategoryInfo": [
   
{
     
"returnReasonCategory": "ITEM_DEFECT",
     
"returnLabelSource": "DOWNLOAD_AND_PRINT",
     
"returnShippingFee": {
       
"type": "FIXED",
       
"fixedFee": {
         
"value": "0.00",
         
"currency": "USD"
       
}
     
}
   
},
   
{
     
"returnReasonCategory": "BUYER_REMORSE",
     
"returnLabelSource": "DOWNLOAD_AND_PRINT",
     
"returnShippingFee": {
       
"type": "FIXED",
       
"fixedFee": {
         
"value": "0.00",
         
"currency": "USD"
       
}
     
}
   
}
 
],
 
"returnPolicyUri": "https://www.example.com/return-policy"
}

создавать

Вы можете использовать returnpolicyonline.create чтобы добавить новую политику возврата. Ответ включает обновленную политику.

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/returnpolicyonline

Вот пример запроса:

{
 
"returnPolicyId": "12345678",
 
"label": "default90days",
 
"name": "returnpolicy90days",
 
"policy": {
   
"type": "NUMBER_OF_DAYS_AFTER_DELIVERY",
   
"days": "90"
 
},
 
"countries": [
   
"US"
 
],
 
"itemConditions": [
   
"NEW",
   
"USED"
 
],
 
"restockingFee": {
   
"fixedFee": {
     
"currency": "USD",
     
"value": "0.00"
   
}
 
},
 
"returnMethods": [
   
"BY_MAIL"
 
],
 
"returnReasonCategoryInfo": [
   
{
     
"returnReasonCategory": "ITEM_DEFECT",
     
"returnLabelSource": "DOWNLOAD_AND_PRINT",
     
"returnShippingFee": {
       
"type": "FIXED",
       
"fixedFee": {
         
"value": "0.00",
         
"currency": "USD"
       
}
     
}
   
}
 
],
 
"returnPolicyUri": "https://www.example.com/return-policy"
}

Вот пример ответа:

{
 
"returnPolicyId": "12345678",
 
"label": "default90days",
 
"countries": [
   
"US"
 
],
 
"name": "returnpolicy90days",
 
"policy": {
   
"type": "NUMBER_OF_DAYS_AFTER_DELIVERY",
   
"days": "90"
 
},
 
"restockingFee": {
   
"fixedFee": {
     
"value": "0.00",
     
"currency": "USD"
   
}
 
},
 
"returnMethods": [
   
"BY_MAIL"
 
],
 
"itemConditions": [
   
"NEW",
   
"USED"
 
],
 
"returnReasonCategoryInfo": [
   
{
     
"returnReasonCategory": "ITEM_DEFECT",
     
"returnLabelSource": "DOWNLOAD_AND_PRINT",
     
"returnShippingFee": {
       
"type": "FIXED",
       
"fixedFee": {
         
"value": "0.00",
         
"currency": "USD"
       
}
     
}
   
}
 
],
 
"returnPolicyUri": "https://www.example.com/return-policy"
}

пластырь

Вы можете использовать returnpolicyonline.patch для обновления существующей политики онлайн-возврата с помощью returnPolicyId .

PATCH https://shoppingcontent.googleapis.com/content/v2.1/merchantId/returnpolicyonline/returnPolicyId

Вот пример запроса:

{
 
"returnPolicyId": "12345678",
 
"label": "default90days",
 
"countries": [
   
"US",
   
"FR"
 
],
 
"name": "returnpolicy90days",
 
"policy": {
   
"type": "NUMBER_OF_DAYS_AFTER_DELIVERY",
   
"days": "90"
 
},
 
"restockingFee": {
   
"fixedFee": {
     
"value": "0.00",
     
"currency": "USD"
   
}
 
},
 
"returnMethods": [
   
"BY_MAIL"
 
],
 
"itemConditions": [
   
"NEW",
   
"USED"
 
],
 
"returnReasonCategoryInfo": [
   
{
     
"returnReasonCategory": "ITEM_DEFECT",
     
"returnLabelSource": "DOWNLOAD_AND_PRINT",
     
"returnShippingFee": {
       
"type": "FIXED",
       
"fixedFee": {
         
"value": "0.00",
         
"currency": "USD"
       
}
     
}
   
},
   
{
     
"returnReasonCategory": "BUYER_REMORSE",
     
"returnLabelSource": "DOWNLOAD_AND_PRINT",
     
"returnShippingFee": {
       
"type": "FIXED",
       
"fixedFee": {
         
"value": "0.00",
         
"currency": "USD"
       
}
     
}
   
}
 
],
 
"returnPolicyUri": "https://www.example.com/return-policy"
}

Вот пример ответа:

{
 
"returnPolicyId": "12345678",
 
"label": "default90days",
 
"countries": [
   
"US",
   
"FR"
 
],
 
"name": "returnpolicy90days",
 
"policy": {
   
"type": "NUMBER_OF_DAYS_AFTER_DELIVERY",
   
"days": "90"
 
},
 
"restockingFee": {
   
"fixedFee": {
     
"value": "0.00",
     
"currency": "USD"
   
}
 
},
 
"returnMethods": [
   
"BY_MAIL"
 
],
 
"itemConditions": [
   
"NEW",
   
"USED"
 
],
 
"returnReasonCategoryInfo": [
   
{
     
"returnReasonCategory": "ITEM_DEFECT",
     
"returnLabelSource": "DOWNLOAD_AND_PRINT",
     
"returnShippingFee": {
       
"type": "FIXED",
       
"fixedFee": {
         
"value": "0.00",
         
"currency": "USD"
       
}
     
}
   
},
   
{
     
"returnReasonCategory": "BUYER_REMORSE",
     
"returnLabelSource": "DOWNLOAD_AND_PRINT",
     
"returnShippingFee": {
       
"type": "FIXED",
       
"fixedFee": {
         
"value": "0.00",
         
"currency": "USD"
       
}
     
}
   
}
 
],
 
"returnPolicyUri": "https://www.example.com/return-policy"
}

удалить

Вы можете использовать returnpolicyonline.delete чтобы удалить существующую онлайн-политику возврата с помощью returnPolicyId . Этот метод возвращает код 200 если запрос успешен, и код 404 , если запрос обнаруживает ошибку.

DELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/returnpolicyonline/returnPolicyId

Вот пример запроса:

{
 
"error": {
   
"code": "404",
   
"message": "Return policy not found.",
   
"status": "NOT_FOUND",
   
"details": [
     
{
       
"type": "type.googleapis.com/google.rpc.ErrorInfo",
       
"reason": "notFound",
       
"domain": "global"
     
}
   
]
 
}
}