Merge pull request #1272 from sendgrid/develop

removed last_email_sent_at 👊

Author: Matt Bernier

.travis.yml

@@ -1,4 +1,6 @@
 language: ruby
+sudo: false
+cache: bundler
 rvm:
 - 2.1
 branches:

_config.sample.yml

@@ -31,9 +31,6 @@ highlighter: pygments # default python pygments have been replaced by pygments.r
 
 titlecase: true       # Converts page and post titles to titlecase
 
-navigation:	#creates a default for showing navigation unless otherwise overridden in individual file's frontmatter
-  show: true
-
 # list each of the sidebar modules you want to include, in the order you want them to appear.
 # To add custom asides, create files in /source/_includes/custom/asides/ and add them to the list like 'custom/asides/custom_aside_name.html'
 default_asides: [asides/page_navigation.html]
@@ -54,14 +51,16 @@ asset_pipeline:
 indextank_api_url: http://:[email protected] #get an index URL at indexden.com
 indextank_index:  docs #set this to the index name you set on indexden.com
 
-# these values are applied as regular expressions
-# indextank_excludes: [index.html, 404.html, ^/secret/]
+# language
+languages: ["en", "es"]
+exclude_from_localizations: ["javascript", "images", "css"]
 
 #pages we link to from many places, change it once here. Must be added to content as {{root_url}}{{site.thisVariable}} in links
 password_requirements: "/Classroom/Basics/password.html"
 app_url: "https://app.sendgrid.com"
 blog_url: "https://sendgrid.com/blog"
 marketing_email_url: "https://sendgrid.com/newsletter"
+marketing_campaigns_url: "https://sendgrid.com/marketing_campaigns"
 pricing_url: "https://sendgrid.com/pricing"
 site_url: "https://sendgrid.com"
 support_url: "https://support.sendgrid.com"

bower.json

@@ -25,7 +25,7 @@
   "dependencies": {
     "bootstrap": "~3.1.1",
     "jquery-ui": "~1.10.4",
-    "modernizr": ">=2.7.2",
+    "modernizr": "=2.7.2",
     "jstorage": "~0.4.8",
     "jsrender": "~1.0.0-beta",
     "highlightjs": "~8.0.0",

source/API_Reference/SMTP_API/scheduling_parameters.md

@@ -61,3 +61,20 @@ To schedule a send request for individual recipients; use `send_each_at` to send
   ]
 }
 {% endcodeblock %}
+
+To allow for the cancellation of a scheduled send, you must include a batch id with your send. The endpoint for cancellation needs a batch id to cancel with. To generate a valid batch id, use the batch id generation endpoint
+
+<h4>Example of including a batch_id</h4>
+{% codeblock lang:json %}
+{
+  "to": [
+    "<[email protected]>",
+    "[email protected]",
+    "[email protected]"
+  ],
+  "send_at": [
+    1409348513
+  ],
+  "batch_id": "MWQxZmIyODYtNjE1Ni0xMWU1LWI3ZTUtMDgwMDI3OGJkMmY2LWEzMmViMjYxMw"
+}
+{% endcodeblock %}

source/API_Reference/SMTP_API/suppressions.md

@@ -23,8 +23,30 @@ You may only specify one group per send, and you should wait one minute after cr
 }
 {% endcodeblock %}
 
+{% anchor h2 %}
+Defining ASM Groups to display on the Manage Preferences page
+{% endanchor %}
+
+To specify which groups to display on the Manage Preferences page of an email, add the group IDs to the X-SMTPAPI header of an SMTP message, or in the x-smtpapi parameter of a [mail.send API
+call]({{root_url}}/API_Reference/Web_API/mail.html).
+If the asm_groups_to_display header is omitted, your default groups will be shown on the Manage Preferences page instead.
+
+{% warning %}
+You can specify up to 25 groups to display.
+{% endwarning %}
+
+{% codeblock lang:json %}
+{
+  "asm_groups_to_display": [1, 2, 3]
+}
+{% endcodeblock %}
+
+{% anchor h2 %}
+Groups
+{% endanchor %}
+
 You can find your group IDs by looking at the Group ID column in the Advanced Suppression Manager UI, or by calling the [GET method]({{root_url}}/API_Reference/Web_API_v3/Advanced_Suppression_Manager/groups.html#-GET) of the groups resource.
 
 Related Articles:
 
-* You can create ASM groups via the [API V3 > ASM Endpoint]({{root_url}}/API_Reference/Web_API_v3/Unsubscribe_Manager/groups.html#-POST).
+* You can create ASM groups via the [API V3 > ASM Endpoint]({{root_url}}/API_Reference/Web_API_v3/Unsubscribe_Manager/groups.html#-POST).

source/API_Reference/Web_API_v3/Advanced_Suppression_Manager/groups.md

@@ -33,8 +33,7 @@ HTTP/1.1 201 OK
 {
   "id":103,
   "name": "Product Suggestions",
-  "description": "Suggestions for products our users might like.",
-  "last_email_sent_at": "NOT IMPLEMENTED"
+  "description": "Suggestions for products our users might like."
 }
 {% endv3response %}
 {% endapiv3example %}
@@ -53,14 +52,12 @@ Retrieve all suppression groups associated with the user.
     "id": 100,
     "name": "Newsletters",
     "description": "Our monthly newsletter.",
-    "last_email_sent_at": "2014-09-04 01:34:43",
     "unsubscribes": 400
   },
   {
     "id": 101,
     "name": "Alerts",
     "description 2": "Emails triggered by user-defined rules.",
-    "last_email_sent_at": "2012-11-06 09:37:33",
     "unsubscribes": 1
   }
 ]
@@ -80,7 +77,6 @@ Get information on a single suppression group.
     "id": 100,
     "name": "Newsletters",
     "description": "Our monthly newsletter.",
-    "last_email_sent_at": "2014-09-04 01:34:43",
     "unsubscribes": 400
 }
 {% endv3response %}
@@ -105,8 +101,7 @@ HTTP/1.1 201 OK
 {
   "id":103,
   "name": "Item Suggestions",
-  "description": "Suggestions for items our users might like.",
-  "last_email_sent_at": "2014-09-05 03:14:15"
+  "description": "Suggestions for items our users might like."
 }
 {% endv3response %}
 {% endapiv3example %}

source/API_Reference/Web_API_v3/Stats/categories.md

@@ -9,7 +9,7 @@ navigation:
 Category Stats provide all of your user's email statistics for your categories.
 
 {% anchor h2 %}
-GET
+GET statistics
 {% endanchor %}
 
 Gets email statistics for the given categories. If you don't pass any parameters, the endpoint will return a sum for each category 10 at a time.
@@ -130,7 +130,7 @@ HTTP/1.1 200
 * * * * *
 
 {% anchor h2 %}
-GET
+GET Sums
 {% endanchor %}
 
 Gets the total sums of each email statistic metric for all categories over the given date range.

source/API_Reference/Web_API_v3/cancel_scheduled_send.apiblueprint

@@ -0,0 +1,131 @@
+---
+layout: page
+weight: 0
+title: Cancel Scheduled Sends
+navigation:
+  show: true
+---
+
+FORMAT: 1A
+
+# Cancellation of Scheduled Sends
+Cancelling scheduled send
+
+# Group Batch IDs
+
+If you set the [SMTPAPI header batch_id]({{root_url}}/API_Reference/SMTP_API/scheduling_parameters.html),
+it allows you to then cancel a scheduled send based on that batch_id by calling the [Cancel Scheduled Send endpoint]({{root_url}}/API_Reference/Web_API_v3/cancel_scheduled_send.html#Cancel-Scheduled-Sends)
+
+## Batch ID Generation [/mail/batch]
+Generate a new Batch ID to associate with scheduled sends
+
+### Generate Batch ID [POST]
+
++ Request
+
+
++ Response 200 (application/json)
+
+    + Body
+
+            {
+                "batch_id": "YOUR_BATCH_ID"
+            }
+
+## Validate Batch ID [/mail/batch/]
+
+### Validate Batch ID [GET]
+
+Validate whether or not a batch id is valid
+
++ Request
+
++ Response 200 (application/json)
+
+    + Body
+
+             {
+                "batch_id": "YOUR_BATCH_ID"
+             }
+
++ Response 400 (application/json)
+
+    + Body
+
+             {
+                "errors":[{"message": "invalid batch id"}]
+             }
+
+
+# Group Cancel Scheduled Sends
+
+The Cancel Scheduled Sends feature allows the customer to cancel a
+scheduled send based on a [Batch ID]({{root_url}}/API_Reference/SMTP_API/scheduling_parameters.html)
+included in the SMTPAPI header.
+
+## Manage user scheduled sends [/user/scheduled_send/{batch_id}]
+
+A CRUD for managing user scheduled sends
+
+### Retrieve scheduled send [GET]
+
+Get cancel/paused scheduled send information.
+
++ Request
+
++ Response 200 (application/json)
+
+   + Body
+
+            {
+               "batch_id": "YOUR_BATCH_ID",
+               "status": "cancel"
+            }
+
+### Update user scheduled send information [PATCH]
+
+Update the status of a scheduled send.
+
++ Request
+
+   + Body
+
+           {
+               "batch_id": "YOUR_BATCH_ID",
+               "status": "pause"
+           }
+
++ Response 204 (application/json)
+
++ Response 404
+
+### Delete a cancellation or pause of a scheduled send [DELETE]
+Delete the cancellation/pause of a scheduled send.
+
++ Request
+
++ Response 204
+
++ Response 404
+
+## Cancel or pause a scheduled send [/user/scheduled_send/]
+
+### Cancel or pause a scheduled send [POST]
+
+Cancel or pause a scheduled send. If the maximum number of cancellations/pauses are added, HTTP 400 will
+be returned.
+
++ Request
+
+   + Body
+
+           {
+               "batch_id": "YOUR_BATCH_ID",
+               "status": "pause"
+           }
+
++ Response 201 (application/json)
+
++ Response 400
+
+

source/Integrate/Code_Examples/java.md

@@ -14,7 +14,10 @@ import com.sendgrid.*;
 
 public class SendGridExample {
   public static void main(String[] args) {
-    SendGrid sendgrid = new SendGrid(api_user, api_key);
+    
+    SendGrid sendgrid = new SendGrid(api_key); // recommended
+    // OR
+    SendGrid sendgrid = new SendGrid(api_user, api_password);
 
     SendGrid.Email email = new SendGrid.Email();
 

source/User_Guide/Suppressions/index.html

@@ -60,5 +60,5 @@
   <strong><a href="{{root_url}}/User_Guide/Suppressions/global_unsubscribes.html">Global Unsubscribes</a></strong> - When a user unsubscribes from everything you might email them.
 </p>
 <p>
-  <strong><a href="{{root_url}}/User_Guide/Suppressions/global_unsubscribes.html">Group Unsubscribes</a></strong> - When a user unsubscribes from a specific group of your emails.
+  <strong><a href="{{root_url}}/User_Guide/Suppressions/group_unsubscribes.html">Group Unsubscribes</a></strong> - When a user unsubscribes from a specific group of your emails.
 </p>