發出 API 呼叫

我們想推出 Beta 版 Merchant API。這是新版本的 Content API for Shopping 與未來發展

如需瞭解 Merchant API 如何改善整合結果，以及如何協助強化整合項目， 未來詳情請參閱 Merchant API Beta 版。

googleads/googleads-shopping-samples GitHub 上的 Repository 包含各用戶端常見作業的程式碼範例 資源庫。舉例來說 googleads-shopping-samples/python/shopping/content/products/ 提供程式碼 進行常見的作業 products敬上 使用 Python 存取資源在本指南中，您將從空白檔案開始著手 並建立插入新產品的範例，這樣您就能看到 建構應用程式所需的結構及所需元件 Content API。最終結果會與 products/insert.py 範例檔案。接著，您可以使用 API Explorer 用於 products.list 方法，以便驗證產品已成功新增。

注意： 這個範例使用 python/shopping/content/common.py 模組來實現 建立可處理驗證及提供介面的服務物件 呼叫 Content APIcommon.py 模組還包含 其他常見作業 (例如產生專屬 ID) 檢查帳戶是否為多重客戶帳戶 (MCA)，然後重試 要求。

如要首次通話，請完成下列步驟：

1. 在 googleads-shopping-samples/python/shopping/content/products/ 中 目錄，建立空白的 my-insert.py 檔案。請將所有程式碼加到 加入這個檔案

2. 為必要模組新增匯入陳述式。

   在 my-insert.py 的開頭加入以下程式碼：

   from __future__ import print_function
   import sys
   
   # The common module provides setup functionality used by the samples,
   # such as authentication and unique id generation.
   from shopping.content import common
   

3. 定義專屬產品 ID，並建立包含產品的字典 定義

   在 my-insert.py 結尾加入以下程式碼：

   offer_id = 'book#%s' % common.get_unique_id()
   product = {
        'offerId':
            offer_id,
        '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',
        'gtin':
            '9780007350896',
        'price': {
            'value': '2.50',
            'currency': 'USD'
        },
        'shipping': [{
            'country': 'US',
            'service': 'Standard shipping',
            'price': {
                'value': '0.99',
                'currency': 'USD'
            }
        }],
        'shippingWeight': {
            'value': '200',
            'unit': 'grams'
        }
   }
   

4. 建立透過指令列執行指令碼時執行的函式。 函式會建構服務物件來與 Content API 互動，取得 設定檔的商家 ID、建構要求，以及執行 要求發出 API 呼叫

   在 my-insert.py 結尾加入以下程式碼：

   def main(argv):
     # Construct the service object to interact with the Content API.
     service, config, _ = common.init(argv, __doc__)
   
     # Get the merchant ID from merchant-info.json.
     merchant_id = config['merchantId']
   
     # Create the request with the merchant ID and product object.
     request = service.products().insert(merchantId=merchant_id, body=product)
   
     # Execute the request and print the result.
     result = request.execute()
     print('Product with offerId "%s" was created.' % (result['offerId']))
   
   # Allow the function to be called with arguments passed from the command line.
   if __name__ == '__main__':
     main(sys.argv)
   
   

5. 如要執行指令碼並執行 API 呼叫，請從終端機視窗前往 前往 googleads-shopping-samples/python/ 並執行：

   python -m shopping.content.products.my-insert
   

   如果呼叫成功，服務會在終端機輸出下列訊息： 優惠 ID 為「offerId」的產品。

6. 如要確認產品是否已成功新增，請使用 API Explorer 使用 products.list 方法，傳回 Merchant Center 中的所有產品 讓他們使用服務帳戶

   注意： products.insert後，這項作業最多可能需要幾分鐘才能完成 呼叫都會完成，產品可使用到 products.list；或 Merchant Center。

   在 適用於 products.list 方法的 APIs Explorer 輸入下列值：

   1. 輸入merchantId。
   ，瞭解如何調查及移除這項存取權。
   注意： 所有其他請求參數皆為選用。
   1. 在「Credentials」(憑證) 部分中，選取「Google OAuth 2.0」(Google OAuth 2.0) 和「API key」(API 金鑰)。
   2. 按一下 [Execute] (執行) 按鈕。
   3. 如果系統顯示提示，請使用與商家相關聯的 Google 帳戶登入 。

   如果產品新增成功，產品資料就會顯示在 API 中。 回應。

商家必須遵守 廣告和免費 產品資訊政策。Google 敬上 Google 購物有權強制執行這些政策及採取適當的回應 如果發現違反這些政策的內容或行為。

注意： 根據預設，透過 Content API 插入的新產品會新增至新 主要動態饋給。進一步瞭解如何使用不同的動態饋給 與 Content API 互動的類型，請參閱 最佳做法。