خدمات محتوای خرید

سرویس محتوای خرید به شما امکان می‌دهد از API محتوای گوگل برای خرید در Apps Script استفاده کنید. این API به کاربران مرکز بازرگانان گوگل این امکان را می‌دهد که لیست محصولات خود را آپلود و مدیریت کنند و حساب‌های مرکز بازرگانان خود را مدیریت کنند.

برای اطلاعات دقیق در مورد این سرویس، به مستندات مرجع برای Google Content API برای خرید مراجعه کنید. مانند تمام سرویس‌های پیشرفته در Apps Script، سرویس محتوای خرید از همان اشیاء، روش‌ها و پارامترهای API عمومی استفاده می‌کند.

مرجع

برای اطلاعات دقیق در مورد این سرویس، به مستندات مرجع Google Content API برای Shopping API مراجعه کنید. مانند تمام سرویس‌های پیشرفته در Apps Script، سرویس Advanced Sheets از همان اشیاء، متدها و پارامترهای API عمومی استفاده می‌کند. برای اطلاعات بیشتر، به بخش «نحوه تعیین امضاهای متد» مراجعه کنید.

برای گزارش مشکلات و یافتن پشتیبانی‌های دیگر، به راهنمای پشتیبانی Google Content API for Shopping مراجعه کنید.

کد نمونه

اکنون نحوه استفاده از چند ویژگی سرویس محتوای خرید را نشان می‌دهیم.

درج محصول

این مثال نحوه درج یک محصول واحد در یک حساب مرکز فروش مشخص را نشان می‌دهد.

محتوای پیشرفته/خرید.gs
/**
 * Inserts a product into the products list. Logs the API response.
 */
function productInsert() {
  const merchantId = 123456; // Replace this with your Merchant Center ID.
  // Create a product resource and insert it
  const productResource = {
    offerId: "book123",
    title: "A Tale of Two Cities",
    description: "A classic novel about the French Revolution",
    link: "http://my-book-shop.com/tale-of-two-cities.html",
    imageLink: "http://my-book-shop.com/tale-of-two-cities.jpg",
    contentLanguage: "en",
    targetCountry: "US",
    channel: "online",
    availability: "in stock",
    condition: "new",
    googleProductCategory: "Media > Books",
    productType: "Media > Books",
    gtin: "9780007350896",
    price: {
      value: "2.50",
      currency: "USD",
    },
    shipping: [
      {
        country: "US",
        service: "Standard shipping",
        price: {
          value: "0.99",
          currency: "USD",
        },
      },
    ],
    shippingWeight: {
      value: "2",
      unit: "pounds",
    },
  };

  try {
    response = ShoppingContent.Products.insert(productResource, merchantId);
    // RESTful insert returns the JSON object as a response.
    console.log(response);
  } catch (e) {
    // TODO (Developer) - Handle exceptions
    console.log("Failed with error: $s", e.error);
  }
}

فهرست محصولات

این مثال نحوه فهرست کردن محصولات برای یک حساب مرکز فروش مشخص را نشان می‌دهد.

محتوای پیشرفته/خرید.gs
/**
 * Lists the products for a given merchant.
 */
function productList() {
  const merchantId = 123456; // Replace this with your Merchant Center ID.
  let pageToken;
  let pageNum = 1;
  const maxResults = 10;
  try {
    do {
      const products = ShoppingContent.Products.list(merchantId, {
        pageToken: pageToken,
        maxResults: maxResults,
      });
      console.log(`Page ${pageNum}`);
      if (products.resources) {
        for (let i = 0; i < products.resources.length; i++) {
          console.log(`Item [${i}] ==> ${products.resources[i]}`);
        }
      } else {
        console.log(`No more products in account ${merchantId}`);
      }
      pageToken = products.nextPageToken;
      pageNum++;
    } while (pageToken);
  } catch (e) {
    // TODO (Developer) - Handle exceptions
    console.log("Failed with error: $s", e.error);
  }
}

محصولات درج دسته‌ای

این مثال از Products.custombatch برای درج همزمان سه محصول استفاده می‌کند.

محتوای پیشرفته/خرید.gs
/**
 * Batch updates products. Logs the response.
 * @param  {object} productResource1 The first product resource.
 * @param  {object} productResource2 The second product resource.
 * @param  {object} productResource3 The third product resource.
 */
function custombatch(productResource1, productResource2, productResource3) {
  const merchantId = 123456; // Replace this with your Merchant Center ID.
  custombatchResource = {
    entries: [
      {
        batchId: 1,
        merchantId: merchantId,
        method: "insert",
        productId: "book124",
        product: productResource1,
      },
      {
        batchId: 2,
        merchantId: merchantId,
        method: "insert",
        productId: "book125",
        product: productResource2,
      },
      {
        batchId: 3,
        merchantId: merchantId,
        method: "insert",
        productId: "book126",
        product: productResource3,
      },
    ],
  };
  try {
    const response = ShoppingContent.Products.custombatch(custombatchResource);
    console.log(response);
  } catch (e) {
    // TODO (Developer) - Handle exceptions
    console.log("Failed with error: $s", e.error);
  }
}

به‌روزرسانی مالیات‌های سطح حساب

این نمونه کد از Accounttax برای به‌روزرسانی اطلاعات مالیات سطح حساب برای یک حساب مرکز فروشندگان استفاده می‌کند. برای اطلاعات بیشتر در مورد مالیات سطح حساب و ارسال، به راهنمای API ما مراجعه کنید.

محتوای پیشرفته/خرید.gs
/**
 * Updates content account tax information.
 * Logs the API response.
 */
function updateAccountTax() {
  // Replace this with your Merchant Center ID.
  const merchantId = 123456;

  // Replace this with the account that you are updating taxes for.
  const accountId = 123456;

  try {
    const accounttax = ShoppingContent.Accounttax.get(merchantId, accountId);
    console.log(accounttax);

    const taxInfo = {
      accountId: accountId,
      rules: [
        {
          useGlobalRate: true,
          locationId: 21135,
          shippingTaxed: true,
          country: "US",
        },
        {
          ratePercent: 3,
          locationId: 21136,
          country: "US",
        },
        {
          ratePercent: 2,
          locationId: 21160,
          shippingTaxed: true,
          country: "US",
        },
      ],
    };

    console.log(
      ShoppingContent.Accounttax.update(taxInfo, merchantId, accountId),
    );
  } catch (e) {
    // TODO (Developer) - Handle exceptions
    console.log("Failed with error: $s", e.error);
  }
}