Impostazioni per i resi degli annunci Shopping e delle schede senza costi

Se inserisci i prodotti tramite gli annunci Shopping o le schede senza costi, puoi utilizzare returnpolicyonline per creare, visualizzare, modificare o eliminare le norme sui resi online con i seguenti attributi:

I prodotti venduti tramite gli annunci Shopping o le schede senza costi non richiedono un indirizzo per il reso.

Per saperne di più, consulta Configurare le norme sui resi per gli annunci Shopping e le schede senza costi.

list

Puoi utilizzare returnpolicyonline.list per elencare tutte le tue norme sui resi online esistenti. Per visualizzare una norma sui resi specifica in base all'ID, consulta get.

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

Ecco una risposta di esempio:

{
 "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"
   }
 ]
}

get

Puoi utilizzare returnpolicyonline.get per ottenere norme sui resi specifiche in base a returnPolicyId. Questo metodo restituisce un'unica norma sui resi. Per visualizzare tutte le norme sui resi contemporaneamente, vedi list.

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

Ecco una risposta di esempio:

{
  "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"
}

create

Puoi utilizzare returnpolicyonline.create per aggiungere una nuova norma sui resi. La risposta include la policy aggiornata.

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

Ecco una richiesta di esempio:

{
  "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"
}

Ecco una risposta di esempio:

{
  "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"
}

patch

Puoi utilizzare returnpolicyonline.patch per aggiornare una norma sui resi online esistente tramite returnPolicyId.

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

Ecco una richiesta di esempio:

{
  "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"
}

Ecco una risposta di esempio:

{
  "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"
}

elimina

Puoi utilizzare returnpolicyonline.delete per eliminare una norma sui resi online esistente tramite returnPolicyId. Questo metodo restituisce un codice 200 se la richiesta ha esito positivo e un codice 404 se la richiesta rileva un errore.

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

Ecco una richiesta di esempio:

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