googleads shopping samples

用於購物和製造商中心API的內容API的示例

這些代碼樣本是通過平台或語言組織的。每個語言目錄都包含一個README ，其中包含有關如何運行該特定語言樣本的更多信息。在這裡，我們涵蓋了設置身份驗證和所有樣本使用的常見配置文件。

有關API的更多信息，請參閱“購物內容和製造商中心API”的內容API文檔。

選擇您的身份驗證方法

在開始之前，請檢查內容API的入門部分中的購物文檔。您可能需要使用服務帳戶來簡化身份驗證流。這些樣本還使用Google應用程序默認憑據支持。

為製造商中心API設置身份驗證與內容API相似。只需確保在API控制台中選擇製造商中心API即可。如果您想嘗試兩個API的示例，則可以選擇兩個API。

設置身份驗證和样本配置

1. 創建目錄$(HOME)/shopping-samples以存儲配置。

   如果您不確定將其位於特定設置中的位置，請運行樣本（遵循特定於語言的README ）。與此目錄或不存在的必要文件相關的樣本中的錯誤將為預期目錄/文件提供完整的路徑。

   在此目錄中，還創建以下子目錄，具體取決於您想嘗試的API：

   • 購物內容API的content
   • 製造商中心API的manufacturers

   將下面描述的文件放在您要嘗試的API的適當子目錄中。

2. 設置您所需的身份驗證方法。

   如果您使用的是Google應用程序默認憑據：

   • 按照Google應用程序默認憑據頁面上的指示。

   如果您使用的是服務帳戶：

   • 在適當的API配置子目錄中，將Service帳戶創建到File service-account.json時下載的JSON文件。

   如果您使用的是OAuth2客戶端ID：

   • 在適當的API配置client-secrets.json中下載您的oauth2客戶端憑據。

     注意：示例假設您使用的是使用oauth2客戶端ID，該ID可以使用loopback ip地址檢索令牌。如果您不是或不確定自己，請訪問[oauth2.0 for Mobile＆Desktop Apps]（https://developers.google.com/identity/protocols/oauth2installedappapp）並按照說明創建一個說明新的OAuth2客戶端ID將與樣本一起使用。

   您可以設置多種身份驗證方法來嘗試不同的流量，但是請注意，樣本將始終使用可以按順序加載的第一個憑據：

   1. Google應用程序默認憑據
   2. 服務帳戶憑據
   3. OAuth2客戶憑證

3. 每組樣本都使用不同的配置文件。對於用於購物的內容API，以存儲庫根的示例merchant-info.json以$(HOME)/shopping-samples/content複製。接下來，適當地更改其內容。它包含一個帶有以下字段的JSON對象：

   場地	類型	描述
   merchantId	數字	商人中心ID可以運行樣本。
   accountSampleUser	細繩	如果非空，則為用戶添加/刪除Accounts服務的示例中的電子郵件地址。
   accountSampleAdWordsCID	數字	如果非零，則ADWORDS客戶ID將在Accounts服務中鏈接/UNLINK鏈接/UNLINK。

   對於製造商中心API，以示例manufacturer-info.json示例，並將其複製到$(HOME)/shopping-samples/manufacturers中。接下來，適當地更改其內容。它包含一個帶有以下字段的JSON對象：

   場地	類型	描述
   manufacturerId	數字	製造商中心ID可以使用樣品。
   websiteUrl	細繩	與製造商中心帳戶相關的URL（不拖曳斜線）。

   如果使用OAuth2客戶端憑據，則一旦您授權訪問，您的令牌詳細信息將存儲在samples配置目錄中的stored-token.json文件中。如果您有任何認證的問題，請刪除此文件，並要求您重新授權訪問權限。

嘗試樣品

現在，您已經配置了常見的示例配置文件並設置您的身份驗證憑據，現在該構建和運行任何隨附的示例了。如前所述，在每個語言子目錄中的README中都有特定於語言的說明。玩得開心！

可能的問題

• 在使用內容API購物時，如果您沒有在帳戶上設置稅收設置，則在運行某些樣本時可能會出現錯誤。如果您收到“丟失的稅收設置”錯誤，請在嘗試這些樣本之前將稅收設置設置在商家中心。選擇“在美國不收取稅款”的設置就足夠了。