دارایی‌ها

قبل‌از ایجاد پویش «عملکرد بیشینه»، مهم است که همه دارایی‌هایی را که قصد دارید در پویش استفاده کنید وارد کنید. همیشه می‌توانید بعداً برگردید و دارایی‌ها را اضافه کنید، اما برای شروع به مجموعه‌ای از دارایی‌ها نیاز دارید.

هنگام برنامه‌ریزی پویش، درباره دارایی‌ها و الزامات دارایی برای پویش‌های «عملکرد بیشینه» مطالعه کنید.

ازآنجایی‌که دارایی‌های نوشتاری و دارایی‌های تصویری انواع دارایی‌های الزامی اصلی هستند، این راهنما نحوه بارگذاری هریک از آن‌ها را نشان می‌دهد. این اصول را می‌توان به انواع دیگر دارایی نیز تعمیم داد. مهم نیست چه نوع دارایی‌ای می‌سازید، از AssetOperation برای ایجاد آن استفاده کنید.

دارایی‌ها را می‌توان بااستفاده از AdsApp بدون استفاده از mutate ایجاد کرد، اما برای حفظ سازگاری، این راهنما آن را به همان روشی انجام می‌دهد که بقیه عملیات‌ها انجام می‌دهند. توجه داشته باشید که اگر دارایی‌های موجودی دارید، می‌توانید و باید از آن‌ها دوباره استفاده کنید. بنابراین، اگرچه برای ایجاد پویش «عملکرد بیشینه» باید دارایی داشته باشید، اما ممکن است لزوماً لازم نباشد که آن‌ها را به‌عنوان بخشی از فرایند ایجاد پویش ایجاد کنید.

دارایی‌های نوشتاری

دارایی‌های نوشتاری درست مثل هر عملیات دیگری کار می‌کنند. اگر دارایی‌ها را به‌عنوان بخشی از فرایند ایجاد پویش بارگذاری می‌کنید، از شناسه موقت استفاده کنید. درغیراین‌صورت، نام منبع برگردانده‌شده را یادداشت کنید تا در عملیات آینده، هنگامی که نیاز به ارجاع به دارایی برای افزودن آن به گروه دارایی دارید، از آن استفاده کنید.

const textAsset = {
  "assetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/assets/${getNextTempId()}`,
      "textAsset": {
        "text": "Travel the World"
      }
    }
  }
}
operations.push(textAsset);

دارایی‌های تصویری

دارایی‌های تصویری در قالب کدبندی‌شده با پایه ۶۴ بارگذاری می‌شوند. ازآنجایی‌که نمی‌توانید تصاویر را مستقیماً در جاوااسکریپت Google Ads بارگذاری کنید، دو رویکرد متفاوت برای دریافت داده‌های تصویر و کدگذاری آن برای بارگذاری دارید.

برای واکشی تصویر از Google Drive، ابتدا به شناسه آن نیاز دارید که بهترین راه برای شناسایی منحصربه‌فرد تصویر است. یک راه برای دریافت شناسه این است که پیوند هم‌رسانی‌شدنی را از میانای کاربری Google Drive کپی کنید و شناسه را استخراج کنید. همچنین می‌توانید مجموعه‌ای از فایل‌ها را به‌صورت برنامه‌نویسی‌شده واکشی کنید و فایل‌هایی را که می‌خواهید بارگذاری کنید انتخاب کنید. این کد نحوه بارگذاری یک تصویر با شناسه مشخص را نشان می‌دهد:

const file = DriveApp.getFileById(fileId);
const imageAsset =  {
  "assetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/assets/${getNextTempId()}`,
      "name": "Marketing Logo",
      "type": "IMAGE",
      "imageAsset": {
        "data": Utilities.base64Encode(file.getBlob().getBytes())
      }
    }
  }
}
operations.push(imageAsset);

یا می‌توانید بااستفاده از UrlFetchApp، تصویری را که در سرور وب میزبانی می‌شود ازطریق نشانی وب آن واکشی کنید:

const file = UrlFetchApp.fetch(imageUrl);

سپس می‌توانید getBlob را در این فایل فراخوانی کنید، درست مانند کاری که با فایل Drive انجام می‌دهید، بنابراین ساختار عملیات با مراحل مربوط به فایل Google Drive یکسان است.